Skip to main content
Your school’s academic structure defines how students, courses, and academic periods are organized. The structure depends on your school type (K-12 (primary and secondary school) or University).
Before you begin: You need an existing school on Lena. See Creating Your School if you haven’t set one up yet.

Organizational structure

K-12 schools use a grades and arms (class sections) hierarchy.

Creating grades

Grades represent class levels (e.g., JSS (Junior Secondary School) 1, JSS 2, SS (Senior Secondary) 1, SS 2, Primary 1).
1

Navigate to School Structure

Go to the School Structure section in the sidebar → Grades. The grades management page appears.
2

Click 'Create Grade'

Enter the grade name (e.g., “JSS 1”, “SS 3”, “Primary 4”). Click Save to add the grade.
Create grade dialog with a text field for entering the grade name
3

Repeat for all grades

Create all the grades your school uses.

Creating arms

Arms are subdivisions within a grade (e.g., Arm A, Arm B, Gold, Silver, Science, Arts).
1

Select a grade

Click on the grade you want to add arms to. The grade detail view opens showing existing arms.
2

Click 'Create Arm'

Enter the arm name (e.g., “Arm A”, “Science”, “Gold”). Click Save and the new arm appears under the selected grade.
3

Repeat for all arms

Add all arms within each grade.
Example structure:
JSS 1
├── Arm A
├── Arm B
└── Arm C
JSS 2
├── Arm A
├── Arm B
└── Arm C
SS 1
├── Science
├── Arts
└── Commercial

Academic sessions

An academic session represents a full academic year (e.g., “2025/2026”).

Creating a session

1

Go to Sessions

Navigate to School StructureSessions. The sessions list appears.
2

Create a new session

Enter the session name (e.g., “2025/2026 Academic Session”) and optionally set start and end dates. Click Save and the session appears in the list.
Create session form with fields for session name, start date, and end date
3

Activate the session

Click Activate to set this as the current active session. Only one session can be active at a time. The session status changes to Active.

Terms and semesters

Within each session, create the time periods that divide the academic year:
Create terms like “First Term”, “Second Term”, “Third Term”.
1

Open the active session

Click on the session to view its details. The session detail page opens showing existing terms.
2

Create a term

Enter the term name, start date, and end date. Click Save and the term appears in the session.
3

Activate the term

Set the current term as active. Only one term can be active at a time. The term status changes to Active.
The active session and period determine which courses are visible and active for teachers and students. Make sure to activate the correct session and term/semester at the start of each period.

Managing structure

Editing

You can rename grades, arms, faculties, departments, sessions, and periods at any time. Changes are reflected immediately across the platform.

Deleting

Deleting a grade, faculty, or department may affect students and courses linked to it. Make sure no students or courses are actively using the structure element before deleting it.

Bulk import via Excel

If your school has many grades or departments, you can import your academic structure from an Excel spreadsheet instead of creating each one manually.
📥 Download K-12 structure import templateImport your entire section/grade/arm structure using a single .xlsx file with the following columns:
ColumnRequiredDescription
Section NameYesThe school section (e.g., “Primary”, “Junior Secondary”, “Senior Secondary”)
Section AbbreviationYesShort code for the section (e.g., “PRI”, “JSS”, “SS”)
Class NameYesThe class numbers within the section — use commas for multiple classes (e.g., “1, 2, 3”)
Arm NamesYesThe arms within each class — use commas for multiple arms (e.g., “A, B, C, D”)
Each row creates grades by combining the section with each class name. For example, a row with Section Name “Junior Secondary” (abbreviation “JSS”) and Class Name “1, 2, 3” creates grades “Junior Secondary 1”, “Junior Secondary 2”, and “Junior Secondary 3”.Example spreadsheet:
Section NameSection AbbreviationClass NameArm Names
PrimaryPRI1, 2, 3, 4, 5, 6A, B, C
Junior SecondaryJSS1, 2, 3A, B, C, D, E
Senior SecondarySS1, 2, 3Science, Arts, Commercial
Use commas to list multiple classes or arms in a single cell. The import creates all combinations automatically — the example above creates 12 grades (6 Primary + 3 JSS + 3 SS), each with their specified arms.
To import, click the Import button on the structure page, select your .xlsx file, review the preview, and confirm.
  • Column headers must match exactly as shown above (case-sensitive) - The file must be in .xlsx format (Excel workbook) - Data must be on the first (active) sheet of the workbook