Home/Documentation/School Admin
Guide 02 · For school administrators

Running your school with School Admin

School Admin is your school's control room: people, classes, login cards, app access, term settings, SMS, and the audit trail. This guide walks through everything — including the exact order to set up a brand-new school so every other app works on day one.

school-admin.simusim.com Sign in: email + password ~25 min read

§ 01Signing in & the dashboard

Go to your school's sign-in page (see Getting started), open the Admin door, and sign in with your email and password. You'll land on the Dashboard.

The sidebar is your map:

  • WorkspaceDashboard, Users, Classes, and Lesson plans (if your school has the Lesson Plans app).
  • People — quick filtered views: Students, Parents, Teachers.
  • OperationsFace check-in, Print cards, Bulk import, Audit, and SMS (if enabled).
  • AccountApps (per-role app access) and Settings.

The dashboard itself shows live counts of students, parents, and teachers, a “Recently added users” list, and quick actions — Import CSV, Add user, Print credential cards, and a link across to Finance.

The School Admin dashboard: counts of students, parents and teachers, an operational-alerts panel, a recently-added-users list, and quick-action cards down the right.
Fig.The dashboard. The left sidebar groups every screen into Workspace, People, Operations and Account.

§ 02First-time setup checklist

Do these in order when your school is new. Several features quietly depend on the earlier steps — for example, you can't create classes until the academic year is set, and report cards can't publish without a term calendar.

  1. Set the academic year and term. Go to Settings, enter the Current academic year in the form 2025/26, type the Current term into its free-text field in the form 2025/26 T1 (format YYYY/YY T[1-3]), and press Save. This becomes the default everywhere — new classes, CSV imports, the Gradebook.
  2. Build the term calendar. Settings → Term calendar: add each term with its name (e.g. “Term 1”), start date, end date, and number of school days. Required before any term's report cards can publish, and used for attendance rates.
  3. Add your subjects. Settings → Subjects: create every subject you teach (Mathematics, English, Integrated Science…). The Gradebook and lesson plans are organised around these.
  4. Create a grade scale. Settings → Grade scales: define how scores map to letters and remarks (e.g. 80–100 → A → “Excellent”). Used on report cards.
  5. Check conduct traits. Settings → Conduct traits: the behaviour categories teachers rate at term wrap-up (e.g. Punctuality).
  6. Create classes. Classes → New class — see § 06.
  7. Add teachers, then students, then link parents. One by one (§ 03) or in bulk from CSV (§ 04 — the CSV can create classes and link parents in the same pass).
  8. Check app access. Apps: confirm which apps each role can use (§ 09). A student who can't see Simu, or a teacher who can't open Gradebook, is almost always an app-access setting.
  9. Print login cards for everyone (§ 07) and hand them out.
Rule of thumb If something elsewhere says “Set the school's current academic year in Settings first” or a list is unexpectedly empty, come back to this checklist — a prerequisite step is missing.

§ 03Creating users one by one

  1. Open Users in the sidebar, then press Add user (top right).
  2. Choose the Role: Student, Parent, Teacher, or Non-teaching staff.
  3. Enter the Given name and Family name.
  4. Fill the role's extra fields:
    • Student — optionally a Code (format ABC-XYZ234: three capital letters, a dash, six characters — look-alike characters such as 0/O, 1/I and 5/S are never used; leave blank and Simusim generates one) and a Class. The class picker also offers Create new class… inline.
    • Parent / non-teaching staff — a Phone number. Local format is fine; it's stored in international form, so 0241234567 and +233241234567 are recognised as the same person.
    • Teacher — a Phone number, plus optionally Homeroom of a class. Each class can have only one homeroom teacher — you'll see an error if it's taken.
  5. Press Create user.
  6. The credentials screen appears once. It shows the new Identifier (student code or phone) and the PIN. From here, press Print card to print immediately, Add another user to keep going, or Done — back to users.
PINs show once PINs are never stored in a readable form. After about 15 minutes, a reprinted card shows •••• instead of the PIN. Print the card (or note the PIN) right away — or simply reset the PIN later to issue a fresh one (§ 08).

Already-taken phone numbers or student codes are rejected with a clear message — two people can't share an identifier within a school.

§ 04Bulk import from CSV

Import up to 500 students per upload (file limit 2 MB), creating classes and linking parents in the same pass. Open Bulk import from the sidebar (or Import CSV on the dashboard).

The file

One student per row. Columns:

ColumnRequiredNotes
given_nameYesFirst name, 1–100 characters.
family_nameYesLast name, 1–100 characters.
parent_phoneNoLocal or international format. Creates (or finds) the parent and links them to the student. Requires parent_name.
parent_nameNoThe parent's full name; required whenever parent_phone is given.
codeNoStudent code in ABC-XYZ234 form (look-alike characters such as 0/O, 1/I and 5/S are never used). Leave blank to auto-generate.
class_labelNoe.g. P.6A. Simusim reuses the class if it exists in the chosen academic year, or creates it.

A minimal example:

given_name,family_name,parent_phone,parent_name,code,class_label
Alice,Mensah,0241112222,Mary Mensah,,P.6A
Kofi,Owusu,,,KMP-XYZ102,P.6B

The four steps

  1. Upload. Optionally set Import for academic year (YYYY/YY; blank = the school's current year), pick your CSV file, and continue. Files with missing required columns, more than 500 rows, or over 2 MB are rejected here with a message saying exactly why.
  2. Preview. Every row is shown with a ✓ or an error (e.g. an invalid phone). You'll also see whether each class_label will be reused or will be created. Fix the file and Re-upload if needed, or press Next.
  3. Confirm. A summary — how many students, classes, and parent links will be created. Press Import.
  4. Result. Counts of everything created. Finish with Done — view users — then go print their login cards.
The CSV import preview (Step 2 of 4): ten rows all marked OK, the classes that will be created, and a row-by-row table of given names, family names, parent phones and class labels.
Fig.Step 2 — Preview. Every row is validated, and you see which classes will be reused vs created before pressing Next: Confirm.
Note Imports can't be undone in bulk. If something was wrong, you can deactivate the affected students afterwards (§ 08) and re-import.

§ 05Managing a user

Open Users, find the person (search box: “Name or identifier”, role chips: All / Students / Parents / Teachers / Non-teaching staff), and click their row. The detail page gathers everything about them:

  • Profile — edit the given/family name and any custom fields your school has defined; press Save changes.
  • App access — tick exactly which apps this person can open, then Save apps. Only apps relevant to their role (and enabled for the school) appear.
  • Linked parents (on a student) — press Add parent, search for the parent, and link them. The parent immediately sees this child in the Parent Portal. Unlink removes the relationship.
  • Linked students (on a parent) — a read-only list of the children this parent is linked to; each row has an Open link to the student. To add or remove a link, do it from the student's detail page.
  • Face enrolment (on a student) — status for the gate kiosk, with consent and enrolment dates (see the kiosk guide).
  • Cumulative transcript (on a student) — press Download transcript for a cross-term academic record PDF that spans every published term. A student with no published terms still produces a valid (mostly empty) PDF.
  • SMS settings — choose the student's primary parent for SMS, or set a parent's announcement opt-out.

§ 06Classes & rosters

Create a class

  1. Open Classes, press New class.
  2. Enter the Label (placeholder JHS 1A; e.g. P.6A, B7 Blue), pick the required Level (the form can't be submitted without it), and set the Academic year (2025/26 — pre-filled from Settings).
  3. Optionally pick a Homeroom teacher. One homeroom teacher per class; the homeroom teacher is who sees the class in Attendance.
  4. Press Create class.

Work the roster

On a class's page you can:

  • Enroll students — pick from students not yet in the class.
  • Withdraw a student, or Transfer them to another class in the same year.
  • Change the label or homeroom teacher with Edit; Archive a class you no longer use (archived classes can be shown again with the “Show archived” filter and unarchived).
  • Subject teachers — under Add subject teacher, choose the subject and teacher and press Add to assign which teacher teaches which subject in this class. This drives the Gradebook and Lesson Plans: a teacher only sees the subjects they're assigned.

§ 07Printing login cards

  1. Open Print cards in the sidebar.
  2. Filter who you want: role (All / Students / Parents / Teachers) and created-within (All time / Last 7 days / Last 30 days). “Last 7 days” is perfect right after an import.
  3. Tick the people to print (or Select all), then press Print cards.
  4. A PDF downloads — 8 wallet-sized cards per A4 sheet with dashed cut lines. Print it, cut, and hand out.
The Print credential cards page: role and created-within filters above a selectable table of users with name, role, identifier and created date.
Fig.Filter, select, and print. “Last 7 days” is ideal right after an import.
Blank PINs? Cards show the PIN only within ~15 minutes of the account being created or the PIN being reset; after that they print ••••. For older accounts: reset the PIN first, then print — the card comes out complete.

§ 08PIN resets, deactivation & reactivation

Reset a PIN

  1. Find the person in Users and press Reset PIN on their row.
  2. Confirm — the previous PIN stops working immediately.
  3. The new PIN is shown once. Print a fresh card or pass the PIN on securely.

Deactivate / reactivate

Press Deactivate on a user's row to remove their access immediately (when someone leaves the school, or after a bad import). Nothing is deleted — their history stays. To bring someone back: tick Show deactivated in the Users filter, find them, and press Reactivate.

§ 09App access — who can open what

Two layers control this:

  1. Per role. Apps in the sidebar shows three columns — Student, Parent, Teacher — each with checkboxes for the apps that role may use. Tick or untick, then Save apps. (Apps your school's subscription doesn't include appear greyed out.)
  2. Per person. On any user's detail page, the App access panel narrows it further for that individual. New users typically need their apps ticked here before the app appears in their portal.
The Apps page showing three columns — Student, Parent, Teacher — each with checkboxes for the apps that role may use, and a Save apps button.
Fig.Per-role app access. Apps your subscription doesn’t include appear greyed out.
Most common support question “Why can't my student open Simu?” — check, in order: ① the school has the app (subscription), ② the role allows it (Apps), ③ the individual has it ticked (user detail → App access).

§ 10Settings

Settings holds the school-wide defaults — the current academic year and term at the top, then cards into each area:

The Settings hub: the current academic year and term at the top, then cards for Subjects, School info, Grade scales, Term calendar, Conduct traits, Custom fields and Face check-in.
Fig.The Settings hub. The year and term sit at the very top; each card opens one area.
  • Curricula — a school can follow more than one curriculum (e.g. Ghana NaCCA and Cambridge International) as parallel streams; subjects, grade scales, and classes are organised per curriculum. See the curriculum guide for the full setup.
  • Subjects — the subject catalogue used by Gradebook and Lesson Plans, grouped by curriculum. Renames apply everywhere, including history; a subject can't be deleted while classes still use it.
  • School info — name, motto, address, logo, and login-page colours; also your report-card identity.
  • Grade scales — map score ranges to letters and remarks. Press Add scale, name it, add rows (min score, max score, letter, remark), then Add scale to save.
  • Term calendar — each term's dates and school days, plus the term's publish action: publishing locks that term's grades and opens the parent-facing report-card PDFs. You can unpublish if something must be corrected.
  • Conduct traits — the behaviour categories teachers rate at term wrap-up.
  • Behaviour categories — the categories (with signed default points) used when logging behaviour incidents (see the behaviour guide).
  • Custom fields — extra fields on students, parents, teachers, staff, or classes (types: short text, long text, number, date, yes/no, single-select, or multi-select).
  • School admins — invite delegated admins, deactivate old access, and reactivate returning staff.
  • Face check-in — gate kiosk devices (§ 13).
  • Bell schedule — define the daily period slots (teaching, break, assembly) used by the timetable (see the timetable guide).
  • Rooms — manage classrooms, labs, and other spaces that can be assigned in the timetable (see the timetable guide).
  • Attendance settings — configure per-period attendance tracking and daily presence derivation rules.
  • Messaging settings — configure parent messaging and SMS nudge behaviour for the school inbox (see the communication guide).

§ 11SMS & announcements

If your school has SMS enabled, SMS in the sidebar shows three cards: Messaging, SMS Wallet, and Sender ID.

Send an announcement to parents

  1. Press Send announcement.
  2. Type the message. The counter shows your length out of 160 characters — and that includes the school-name prefix automatically added to every message (e.g. KUMASIPREP: ).
  3. Choose the audience: All parents in the school or Parents of a specific class.
  4. Check the live cost: each parent receives one SMS at ₵0.06 (6 pesewas). The exact recipient count is confirmed on the announcement's detail page after you send, not live in the composer.
  5. Press Send announcement. Messages composed during quiet hours (21:00–07:00) are scheduled for 07:00 the next morning unless you tick Send now (override quiet hours).
  6. The announcement page then tracks delivery per recipient. Dispatch history lists everything ever sent.

Wallet & sender ID

  • Wallet — every SMS draws from your school's wallet. Below GHS 5.00 you'll see a Low balance badge and a warning that outgoing SMS may fail; press Request top-up to email the Simusim team, then pay by your usual method.
  • Sender ID — request your school's own sender name (max 11 characters); fill the request form and press Submit request. The Simusim team registers it with the network regulator and approves it. Until then, messages go out from the shared “SimuSim” sender.
  • Parents who shouldn't receive announcements can be opted out on their user page; students with several linked parents have a primary parent for SMS you can choose.

Message templates

Open SMS → Templates to see the nine messages Simusim can send. They're platform-defined and can't be edited — your school's name is filled in automatically, and PINs always show as ****. Most fire on their own; the last is the one you compose.

TemplateWhen it's sent
Student absence alertA student is marked absent.
Fee invoice issuedA new fee invoice is generated for a student.
Fee due reminder (7 days)7 days before the fee due date.
Fee due reminder (1 day)The day before the fee due date.
Fee overdue reminderA fee invoice is past its due date.
Fee payment receiptA fee payment is recorded.
Parent PIN resetA parent's login PIN is reset by an admin.
Login PIN deliveredA new account is created and its PIN delivered.
School announcement (broadcast)You send it via the Send announcement composer.
The Message templates page listing the nine platform-defined SMS templates, each with its trigger and an example rendering, with a note that they can't be edited.
Fig.The nine templates are read-only previews — the school name and values are examples; yours fill in automatically.

§ 12Lesson-plan reviews

When teachers submit weekly lesson notes (see the teacher guide), they arrive in Lesson plans — the review queue, filtered to Submitted by default. Filter by class, subject, teacher, week, or status. Open a note to read it, then either:

  • Approve — the teacher sees a green Approved badge, or
  • Request revision — opens a feedback box; add your comment and press Send revision request. The note returns to the teacher marked Needs revision with your comment attached.

§ 13Face check-in devices

Settings → Face check-in (also Face check-in in the sidebar) manages your gate tablets:

  1. Under Register a device, enter a device name (e.g. “Main gate”) and an optional location, then press Register device. A one-time pairing code like ABCDE-FGHJK appears — it's valid for 10 minutes and shown once.
  2. On the gate tablet, open kiosk.simusim.com, type the code, and press Pair device.
  3. The device appears in your Registered devices list, where you can watch its last-seen time or Revoke it instantly if the tablet is lost. The device name is set once when you register it and can't be changed afterwards.
  4. Toggle gate SMS notifications here if you want parents to receive an SMS when their child checks in or out.

Face enrolment, daily use, and troubleshooting are covered in the dedicated kiosk guide.

§ 14The audit log

Audit is the read-only history of everything done in your school — user created, PIN reset, class archived, term published, announcement sent — newest first. Filter by action, target type, or date range; click any row for the full before/after detail; press Export CSV to take it to a spreadsheet.

Use it whenever you need to answer “who changed this, and when?”

§ 15Co-admins

You don't have to run the school alone. Settings → Admins ("School admins") manages your fellow administrators. Fill Full name, Email and optionally Phone, then press Invite. Each admin appears in the Current admins table with an Active or Deactivated status; use Deactivate when someone leaves and Reactivate if they return.

The School admins page: an invite form with Full name, Email and Phone, above a table of current admins each showing an Active status and a Deactivate action.
Fig.Co-admins get the same powers you have — deactivate one the moment they leave.

§ 16Student lifecycle

Lifecycle tracks students as Active, Withdrawn, Transferred out or Graduated without ever losing their history. Filter by Status or search by name or code.

  • Record an exit — on an active student press Record exit, choose the status, set the effective date, add a Reason (and a Destination school for transfers), tick Deactivate login if they should no longer sign in, and Save exit.
  • Reinstate — on a non-active student press Reinstate, set the effective date and reason, optionally a new class label, tick Reactivate login, and confirm.
The Student lifecycle page: a status filter and search, and a table of students showing class, status pill, linked-parent count, and a Record exit action per row.
Fig.Handle leavers here before a year rollover, so only continuing students are promoted.

§ 17Year rollover

At year-end, Year rollover moves your whole school forward in one pass. Enter a Source year and Target year, press Preview, set each class to promote, graduate or review (with a target class for promotions), then — once no class is left on review — press Commit rollover. Options let you Archive source classes and Set current academic year to the new one.

The Year rollover page: source and target year inputs, a preview table of each class with its student count, a promote action and a target class, and Archive / Set-current-year checkboxes.
Fig.The preview is non-destructive — nothing moves until you press Commit rollover.

Step-by-step, with the preview table explained, in the Year rollover tutorial.

§ 18Data quality

Data quality surfaces record gaps as five counts — Students without active class, Students without linked parent, Missing primary parent for SMS, Duplicate candidates, and Failed identifier sync — and lets you fix login identifiers safely. Use Correct identifier (membership ID + new identifier → Save correction) or, after a failed sync, Retry sync. Possible duplicates are listed below, or "No duplicate candidates found."

The Data quality page: five KPI counts across the top, a Correct identifier panel and a Retry identifier sync panel, and a duplicate-candidates table below.
Fig.Clear these during the term — not the night before report cards.

§ 19Reports & exports

Reports exports your operational data as CSV. Four reports are available, each with a Download CSV button: Enrollment (lifecycle status, class placement, parent-link counts), Contacts (identifiers, phones, emails, emergency contacts), Parent links (student-to-parent links and primary-parent flags), and Attendance exceptions (unexcused absences, lates, and exception notes).

The Reports page showing four cards — Enrollment, Contacts, Parent links and Attendance exceptions — each with a row count and a Download CSV button.
Fig.Each card shows its current row count and downloads a spreadsheet-ready CSV.

§ 20Parent access

Parent access shows where parents are missing or mis-linked, as five coverage counts — No linked parent, Parent deactivated, Missing primary parent, Missing parent app access, and Parent without child — with a table of each issue and the student, parent and identifier involved. When everything is in order it reads "Parent access setup is complete."

The Parent access page: five coverage KPIs across the top and a table listing each issue with the student, parent and identifier.
Fig.Every gap here is a parent who won't get grades, fees or SMS. Fix them from each user's page.

§ 21Per-class oversight

Open any class and you'll see a tab strip: Roster, Attendance, Gradebook, Report cards, Lesson Plans. Gradebook and Report cards are read-only oversight — teachers do the grading in their own apps; you watch and unblock.

  • Attendance — a grid of the last 14 days, every active student against each date, with statuses present, absent or late. The grid is editable: click a cell to open an edit drawer and save a correction. Use Export CSV to download it.
  • Gradebook — a term grid of students × subjects, colour-coded term grades, with a term selector. Teachers create the assignments inside the Gradebook app.
  • Report cards — once a term is published, Download class bundle for the whole class or Download PDF per student.
A class Gradebook oversight tab with the class header, the Roster/Attendance/Gradebook/Report cards/Lesson Plans tab strip, a term selector and an Export CSV button.
Fig.The Gradebook oversight grid. Attendance and Report cards sit on the same tab strip.

§ 22Publishing a term

Report cards open to parents when you publish a term from Settings → Term calendar. Pressing Publish opens a readiness check that counts how many students are ready and flags two kinds of issue: a hard block ("Term calendar not configured." — add the term first; each class also shows a "Term calendar missing" status chip) and an advisory warning (some students missing grades, conduct or comments — tick Publish anyway to proceed). Publishing locks the term's grades and comments; you can unpublish from the same row to make corrections.

The Publish-term dialog showing a readiness summary, a per-class breakdown of how many students are ready, and a Publish anyway acknowledgement checkbox.
Fig.The full flow — readiness, publishing and distributing the PDFs — is the Report cards tutorial.

Also for adminsMore admin guides

Several admin-facing areas have their own dedicated guide:

Up nextRelated guides

Help · answered by our team, not a bot

Can't find your answer?

Email us and a real person on the Simusim team will get back to you. School staff can also reach us through their school's usual support channel.