Exams

Exams is for schools, colleges, training centres and exam bodies that set and mark their own exams. You keep a question bank per subject, plan each exam's papers on a timetable that is checked so no candidate sits two papers at once, put candidates in rooms with seating plans and invigilators, print papers with a marking scheme or give them online in the portal with a time limit, and let each teacher enter the marks for their own paper. Once marks are moderated, Exams works out grades, points, means, positions and class positions, prints result slips, shows the analysis and releases the results to candidates and guardians in the portal. With School Management switched on, it uses School's students, classes and subjects and puts the results on School report cards.

It is in the Examinations group of the left menu: Exams, Marks entry, Question bank, Online answers, Results and analysis, Candidates, Subjects, Rooms and Grading scales.

Note: You need the exams.view permission to see the Examinations pages and printouts. With it, a teacher can enter marks for the papers they are named on, add questions to the bank and mark online answers for their papers. exams.manage is needed to create exams and papers, set rooms and seating, enter marks for any paper, moderate, release and withdraw results, and manage candidates, subjects, rooms and grading scales. Owners and admins have both. Give teachers a role with exams.view only. Set permissions under Settings → Roles.

Switch on Exams

Exams is an add-on sold separately from your plan. It needs the Contacts app; it works on its own, and also with School Management.

  1. Open Settings → Marketplace and type Exams in the search box (marker 1).
  2. On the Exams card (marker 2), click Start free trial (or Add to subscription) and confirm. The Examinations group appears in the menu, and candidates and guardians get Exam results in the portal.
Marketplace searched for Exams, with the search box and the Exams card marked
Marketplace searched for Exams, with the search box and the Exams card marked

If the card says Not available for purchase yet, ask NaliSuite support to switch it on. See Billing and marketplace.

Exams settings

  1. Open Settings → Preferences and click the Exams tab (marker 1).
  2. Change the settings and click Save preferences (marker 4).
Exams preferences with School grading scale, the results email switch and Save preferences marked
Exams preferences with School grading scale, the results email switch and Save preferences marked
Setting Default What it does
School grading scale (marker 2) KCSE-style A to E with points The scale used by every exam that does not choose its own. Add scales under Examinations → Grading scales first.
Email candidates or guardians when results are released (marker 3) On When you release results, each candidate's portal contact is emailed their mean, grade and position, with a See the results button.

Set up subjects, candidates, rooms and grading scales

Do this once, before your first exam.

Subjects

Open Examinations → Subjects.

Subjects with Bring in School subjects, Add a subject and On report cards marked
Subjects with Bring in School subjects, Add a subject and On report cards marked

Candidates

Open Examinations → Candidates.

Candidates with Bring in School students, Add a candidate, a class, the portal contact and From School marked
Candidates with Bring in School students, Add a candidate, a class, the portal contact and From School marked

Rooms

Open Examinations → Rooms, click Add a room (marker 1) and type the Room name, its Seats (marker 2) and Desks in a row (marker 3). Seats are labelled A1, A2… row by row on the seating plan.

Exam rooms with Add a room, Seats and Desks in a row marked
Exam rooms with Add a room, Seats and Desks in a row marked

Grading scales

Exams grades on a KCSE-style scale unless you add your own: A from 80 (12 points), A- from 75 (11), B+ 70 (10), B 65 (9), B- 60 (8), C+ 55 (7), C 50 (6), C- 45 (5), D+ 40 (4), D 35 (3), D- 30 (2) and E below (1).

  1. Open Examinations → Grading scales and click Add a grading scale, or Edit on one.
  2. Type the Name (marker 1), then each grade (marker 2): the lowest mark From mark that earns it, the Grade, its Points and a Remark such as Meeting expectations. Add a grade (marker 3) adds a row. A new scale starts filled with the KCSE grades for you to change.
  3. Click Save changes. Choose it as the School grading scale in Settings, or on an exam.
A CBC primary grading scale with Name, the grades and Add a grade marked
A CBC primary grading scale with Name, the grades and Add a grade marked

When every grade on the scale has points, candidates get mean points and the overall grade comes from the mean points, KCSE style. Leave Points empty to grade on the mean mark instead.

The question bank

Open Examinations → Question bank. Each question shows its subject, Kind (marker 3: Multiple choice, Short answer or Essay), Topic (marker 4), difficulty, marks and whether it is In use. Use the filter (marker 2) to show one subject, kind, topic or difficulty.

Question bank with Add a question, the filter, a question's kind and topic marked
Question bank with Add a question, the filter, a question's kind and topic marked

Click Add a question (marker 1), or Edit on one:

Edit question window with Subject, Kind, Topic, Difficulty, the answers, the right answer and Marks marked
Edit question window with Subject, Kind, Topic, Difficulty, the answers, the right answer and Marks marked
Field What to enter
School subject (required, marker 1) The subject's bank it goes in.
Kind (required, marker 2) Multiple choice, Short answer or Essay.
Topic (marker 3) Type a topic or pick one already used, such as Water. Used to pick questions at random.
Difficulty (required, marker 4) Easy, Medium or Hard.
Question (required) The question as candidates see it.
Answers to choose from (marker 5, multiple choice) Two to eight answers.
Number of the right answer (marker 6, multiple choice) 1 for the first answer, 2 for the second, and so on.
Marking guide (short answer and essay) What earns the marks. Printed on the marking scheme.
Marks (required, marker 7) What the question is worth.
Use in papers Off to keep the question but stop it being added to papers.

Create an exam and its timetable

  1. Open Examinations → Exams. Each exam shows when it starts, the Classes sitting (marker 2), its number of papers and whether its Results are Released (marker 3).
Exams list with New exam, the classes sitting and a released exam marked
Exams list with New exam, the classes sitting and a released exam marked
  1. Click New exam (marker 1), fill in the form and click Create.
Exam form with the classes sitting, Grading scale, Compare with, Report card term, Counts for, Check clashes, Print and results and Release results marked
Exam form with the classes sitting, Grading scale, Compare with, Report card term, Counts for, Check clashes, Print and results and Release results marked
Field What to enter
Exam (required) End of term 3 exam 2026.
Starts (required) and Ends The exam's dates.
Classes and streams sitting (marker 1) The classes or streams that sit the exam. Leave empty for every active candidate.
Grading scale (marker 2) Leave empty for the school scale in Settings.
Compare with (marker 3) An earlier exam, such as the opener exam. The analysis and result slips show the change on it.
Report card term (marker 4, School on) The School term whose report cards get the results. Empty: the current term.
Counts for (%) of the term mark (marker 5, School on) The weight of this exam on the report card, like a School exam's weight. Default 100.

The exam's page has Check clashes (marker 6), Print and results (marker 7: Timetable PDF, Result slips PDF and Results and analysis) and Release results (marker 8).

Add papers

Under the form, Papers and timetable lists each paper with when it is sat and for how long (marker 2), the classes, its Rooms with how many are seated (marker 3), the number of questions from the bank, whether it is Online, and its Marks status (marker 4: Being marked, Waiting for moderation or Moderated) with how many marks are entered. Marks (marker 5) opens the paper's marks entry, and ⋮ (marker 6) holds its other actions (see below).

Papers and timetable with Add a paper, a paper's time, its room and seating, a marks status, Marks and the ⋮ menu marked
Papers and timetable with Add a paper, a paper's time, its room and seating, a marks status, Marks and the ⋮ menu marked

Click Add a paper (marker 1) and fill in the window:

Create paper window with Subject, Classes and streams, Starts, Marked out of, Teacher entering marks and Sat online in the portal marked
Create paper window with Subject, Classes and streams, Starts, Marked out of, Teacher entering marks and Sat online in the portal marked
Field What to enter
School subject (required, marker 1) and Paper (required) Mathematics, Paper 1.
Classes and streams (marker 2) Only some of the exam's classes sit this paper. Empty: everyone sitting the exam.
Starts (marker 3) and Minutes (required) The date and time on the timetable, and how long the paper is.
Marked out of (required, marker 4) Default 100. Set for you from the questions when you build the paper from the bank.
Teacher entering marks (marker 5) The teacher who marks this paper. They can enter its marks and see its marking scheme.
Sat online in the portal (marker 6) On to give the paper online (see Online papers in the portal).
Instructions to candidates Printed on the paper and shown online.

Click Create. If the time would make any candidate sit two papers at once, the paper is not saved and you see Timetable clash: This clashes with English · Paper 1: 3 candidates would sit both at once (…). Change the time or the classes.

Check for clashes

Click Check clashes at the top of the exam. The window lists every pair of papers that overlap where a candidate sits both, or where both use the same room at the same time, or says No clashes. No candidate sits two papers at once and no room is double booked. Room double booking is only reported here; it does not stop a paper being saved.

Rooms, seating, questions and printing

Click ⋮ on a paper:

The ⋮ menu of a paper with Rooms and invigilators, Seat the candidates, Add questions from the bank, Moderate and Send back to the teacher marked
The ⋮ menu of a paper with Rooms and invigilators, Seat the candidates, Add questions from the bank, Moderate and Send back to the teacher marked

Enter marks and moderate

  1. Teachers open Examinations → Marks entry, or click Marks on a paper.
  2. Choose the Paper (marker 1). Teachers see only the papers they mark; exam managers see every paper of exams not yet released.
  3. Type each candidate's mark (marker 2), ABS for absent, or leave it empty. Marks run from 0 to the paper's Marked out of.
  4. Click Save marks (marker 3) as often as you like. When finished, click Submit for moderation (marker 4) and confirm. The marks are then locked for the teacher.
Marks entry with the paper, a candidate's mark, Save marks and Submit for moderation marked
Marks entry with the paper, a candidate's mark, Save marks and Submit for moderation marked

To moderate, someone with exams.manage clicks ⋮ → Moderate on a paper Waiting for moderation, types Marks to add to everyone (negative to take off), for example 2 or -3 (0 to approve as entered), and clicks Submit. The paper becomes Moderated. No candidate's mark goes above the paper's total or below 0. Send back to the teacher reopens a paper's marks for changes, until results are released.

Online papers in the portal

A paper with Sat online in the portal opens in the portal at its Starts time and closes when its Minutes have passed. Build it from the question bank first.

  1. Candidates (or the guardian, on their behalf) open Exam results in the portal. The paper shows Open once it starts, Not open yet before, and Closed after.
  2. Open, then Start the paper. From that moment they have the paper's minutes, but never past the paper's closing time, so starting late gives less time. Each candidate can start once.
  3. The page shows Time left (marker 1), the instructions, each question (marker 2) with radio buttons for multiple choice and a box (marker 3) for written answers. Carry on in the portal returns to a paper already started.
  4. They click Hand in my answers (marker 4). When time runs out the page hands the answers in by itself; answers arriving more than two minutes after the deadline are not accepted, and the candidate sees Time ran out before the answers arrived, so none were recorded.
Online paper being sat, with Time left, a multiple choice question, a written answer box and Hand in my answers marked
Online paper being sat, with Time left, a multiple choice question, a written answer box and Hand in my answers marked

Multiple choice is marked as soon as the answers are handed in, and the total becomes the candidate's mark for the paper (while its marks are still being marked).

Mark written answers

Open Examinations → Online answers. Each sitting shows when it was started and handed in (marker 1: Still writing until then), the Multiple choice marks (marker 2) and Written (marker 3: To mark, or the written marks given).

Online answers with Still writing, the multiple choice marks, To mark and Mark written answers marked
Online answers with Still writing, the multiple choice marks, To mark and Mark written answers marked

Click Mark written answers (marker 4). For each short answer or essay question you see the question and the candidate's Answer (marker 1); type the Marks out of the question's marks (marker 2) and click Submit. The paper mark becomes the multiple choice marks plus the written marks. The paper's teacher or an exam manager can do this while the paper is being marked.

Mark written answers window with a candidate's answer and Marks out of marked
Mark written answers window with a candidate's answer and Marks out of marked

Results and analysis

Open Examinations → Results and analysis (or Print and results → Results and analysis on an exam). Choose the Exam and, if you like, one Class (marker 1). It works as soon as marks are entered, before release.

Results and analysis with the class filter, Result slips, the change on the previous exam, a broadsheet row, Subject means and Grade distribution marked
Results and analysis with the class filter, Result slips, the change on the previous exam, a broadsheet row, Subject means and Grade distribution marked

How results are worked out:

Release results

When every paper is Moderated, click Release results on the exam and confirm. If a paper is not moderated you see Moderate every paper first. Still waiting: Science and Technology · Paper 1. On release:

You see Results released for 7 candidates and how many marks were added to report cards. Marks can no longer be changed. To correct something, click Withdraw results and confirm: the results leave the portal and the report cards until you release them again, and you can send papers back to their teachers.

What candidates and guardians see in the portal

A contact set as Sees results in the portal on a candidate (with School, the student's guardian) gets Exam results in your customer portal once there are released results or an online paper. A guardian with two children sees a card for each.

Portal Exam results for a guardian with two children, with Carry on, Open, a released result and Result slip marked
Portal Exam results for a guardian with two children, with Carry on, Open, a released result and Result slip marked

To give a guardian access, invite their contact to the portal (see Customer and vendor portal).

Working with School Management

Exams works on its own with candidates and subjects you add. When School Management is on as well:

Good to know