Setting up an institute — step by step
From an empty institution to a school that can open its doors: profile, school year, grades, classes, subjects, staff, students and guardians. Fill in your own data as you go: the guide checks it, uses it in every link and example, and turns it into the import files the Migration wizard expects.
The big picture
Each step needs the one before it: a class needs a grade, a class subject needs a class, a student needs a class. Work from left to right.
Who does what
| Task | Platform administrator super admin | Institution administrator admin | Principal |
|---|---|---|---|
| Create the institution and its first admin | yes | – | – |
| School year (academic period) dates | yes (shared by every institution) | – | – |
| National grade catalogue (levels, cycles, programmes, grades) | yes | tick what you offer | – |
| Profile, terms, classes, subjects, staff, students | yes | yes, own institution | most of it |
| Institution roles and users | yes | yes, own institution | – |
1. Institution profile
If the institution does not exist yet, a platform administrator creates it together with its first administrator in Create Institution. Everything else below is done by that administrator.
Your institute
- Open Edit › Profile and fill every classification field. Type, ownership, sector, provider, gender, locality, status and area are required — an empty one is never saved as a guess.
- Same page › Finance: set the currency () and the number of decimals. Fees, payroll and reports all print in it.
- Optional: logo and colours for the portals in Portal design.
2. School year and terms
The academic period is the school year. It is shared by every institution, so only a platform administrator creates or extends it. Terms (semesters) belong to your institution and must sit inside the period.
Your school year
Terms
- Platform administrator: create or extend the period in Academic Periods so it runs → . A period cannot be shortened below a term that already exists.
- Create each term in Timetable Terms. A term that starts before or ends after the period is refused with the reason.
3. Grades offered
Grades come from a national catalogue (level › cycle › programme › grade). You tick the ones your institution teaches this year. If a grade is missing from the catalogue, ask the platform administrator to add it.
Grades you teach ()
- Tick the grades in Grades Offered (or step 1 of University Setup).
- Or upload
02-grades.csv(download it below) in Institute migration: Validate first, then Apply. Missing grades are created from the names you gave.
4. Classes
At least one class for every grade. Capacity is the seat limit used when students are placed.
Classes ()
- Create them in step 2 of University Setup (the class is linked to its grade for you), or in All Classes.
- Homeroom teachers can be set later, once staff exist, in Primary Teacher Assignment.
5. Subjects and lessons per week
Each class needs its subjects. The number of lessons per week is what the timetable generator places, so set it here once.
Subjects per class ()
- Offer the subjects per grade in step 3 of University Setup, or in Subject Offerings.
- Set lessons per week per class in Curriculum Setup › Classes (you can also change it later inside the timetable generator).
- The curriculum (outcome templates per grade) is explained in the Academic Setup guide.
6. Staff, logins and roles
Every staff member gets one login and one role. The role decides which pages they see; their classes decide which students they see. Teachers are attached to a class + subject, so they only see the classes they actually teach.
Staff ()
- Positions first. Create the position slots (e.g. POS-001 Teacher) in Institution Positions; staff onboarding offers only these.
- Add each employee with Staff Onboarding: personal details, a username and password (at least 6 characters), the access role, the position and the monthly base salary. This one wizard creates the login, the employment record, the role and the salary structure. Staff must be at least the minimum age set in Staff Config (18 by default).
- People who need a login but are not employees in the staff list (an external accountant, for example) are added in University Users, where you can also set a password if an email cannot be delivered.
- Attach a teacher to each class subject in step 5 of University Setup.
- Need a role that does not exist (for example a finance clerk)? Clone a template in Institution roles and tick its pages. Templates FINANCE_ADMIN, STAFF_ADMIN and REGISTRAR are ready to clone.
7. Students and guardians
A student is enrolled in the institution and placed in one class per year. Guardians are linked to their children, so one parent account sees all of them.
Students ()
Guardians ()
- Decide which questions the forms ask (email, mobile, birthplace, guardian requirements) in Student Config (platform administrator).
- Enrol each student with Student Onboarding: personal details, identity documents, guardians, then the class. Or let families apply and work the Admissions pipeline; the class is confirmed when you click Approve & assign class.
- Guardians added later, or a guardian shared by siblings, are managed in Guardian Management.
- When fee structures exist (step 10), every new enrolment is invoiced automatically. Students enrolled before that are picked up by the nightly check or by “Generate the missing invoices” on the invoices page.
The full journey — admission, transfer, withdrawal and promotion — is in the Student Lifecycle guide.
8. School day and holidays
- In Calendar Setup › School day: create the day pattern (periods with times, breaks, lunch) and tick the school days.
- In Calendar Setup › Holidays: apply the country's public holidays (preview first) and add your own school holidays and closures.
- Set the first day of the week () on the same page.
9. Curriculum, timetable and lesson planning
Everything from outcome templates to a published timetable and the calendar is explained, with a sample class, in the Academic Setup guide. In short:
- Curriculum templates and outcomes: Curriculum Onboarding.
- One timetable per class and term, generated and published in Timetable Builder (Generate whole grade does all classes of a grade at once).
- Teachers link outcomes to their lessons in Lesson Planning.
10. Fees
Create fee types and one fee structure per grade with the Fee Setup Wizard. From then on every enrolment is invoiced automatically. Payments, discounts, installments and payroll are in the Finance & Payroll guide.
11. Go live
- Open the Academic Setup Checklist: every step should be Ready. Each warning names what is missing and links to the page that fixes it.
- Check readiness per grade in Readiness and data problems in Data health.
- Sign in once as a teacher, a student and a guardian and check that each sees their own classes, timetable and children only.
- Platform administrator: confirm a person's exact access in Effective access.
- Print or save this guide and your data file (Save my data at the top) as the setup record.
Import files from your data
Everything you typed above can be downloaded in the exact format of the Migration templates (01-institution.csv … 07-guardians.csv): UTF-8, header row unchanged, dates as YYYY-MM-DD.
Troubleshooting
| You see | Why | Fix |
|---|---|---|
| “This code is already used by another institution” | Institution codes are unique. | Choose another code; it never changes afterwards. |
| “The term cannot end after its academic period” | The school year (period) is shorter than your terms. | Ask the platform administrator to extend the period first. |
| A grade is missing from the Grades Offered tree | It is not in the national catalogue. | The platform administrator adds it under Settings › Education Structure. |
| A new staff member sees nothing after login | No role, or no class subject for a teacher. | Check the role in University Users; attach the teacher in University Setup step 5. |
| A class cannot take more students | The class is full (capacity). | Raise the capacity or open another class. |
| Password-reset email never arrives | The address is not deliverable. | Use Set password in University Users and hand it over. |
| A new student has no invoice | No fee structure for the grade, or automatic invoicing is off. | Create the structure; use “Generate the missing invoices”. |