Documentation
Step-by-step guides for using Examora.ng — a Computer Based Testing (CBT) platform for everyone, including the visually impaired. This documentation covers Organisation admins, Teachers, and Students.
Getting started
Quick start
A fast checklist to go from a new organisation account to a student submitting an exam.
1) Register your organisation
Create your organisation admin account on Sign up.
2) Add subjects
Go to Org → Subjects and add the subjects your school uses.
3) Add teachers and students
Create accounts in Org → Teachers and Org → Students.
4) Create and publish an exam
Create an exam in Org → Exams, add questions, then Publish.
5) Students take the exam
Students sign in and start the exam from Student → My exams.
6) View results
See submitted attempts in Org → Results.
Role guide
Organisation (Admin)
Set up your organisation, create exams, publish them for students, and track results.
Tip
Students can only see exams that are Published.
Organisation sign up
- Go to Register your organisation.
- Enter your Organisation name.
- Enter an Admin email (this becomes the org admin account).
- Create a password, then click Create account.
- You will be redirected to the Org dashboard.
Sign in & dashboard
- Go to Sign in.
- Sign in with the email + password for your role.
- After sign-in:
- Org Admin / Teacher go to Org dashboard.
- Student goes to Student dashboard.
Add subjects
- Open Org → Subjects.
- Add the subjects your school uses (for example: English, Maths).
- Confirm the subject appears under All subjects.
Add teachers
- Open Org → Teachers.
- Click Add teacher.
- Fill in teacher details (first name, last name, email, password).
- Click Add teacher.
- Share the login details with the teacher so they can sign in.
Add students
- Open Org → Students.
- Click Add student.
- Fill in details (first name, last name, email, password; phone optional).
- Click Add student.
- Share the student’s email + password with them to sign in.
Create an exam
- Open Org → Exams.
- Click Create Exam.
- Select a Subject, then set:
- Time limit (minutes)
- Questions per attempt (picked randomly from the full question pool)
- Add questions using either method:
- Upload CSV with columns
question,optA,optB,optC,optD,ANSWER - Add questions manually in the form
- Upload CSV with columns
- Click Create exam.
Manage questions
- Open Org → Exams.
- Find the exam and click Manage questions.
- Update questions by:
- Edit in form (add/remove rows and save)
- Upload new CSV (replaces all questions)
- Click Save questions.
Publish an exam
- Open Org → Exams.
- If an exam is in draft, students cannot see it yet.
- Click Publish for the exam.
- Students will now see it on Student → My exams.
View results & allow reattempts
- Open Org → Results.
- Filter by exam (optional) to focus on one exam.
- Review each submitted attempt (score + date/time submitted).
- To let a student retake an exam, use Allow reattempt in the Actions column.
Subscription & billing
- Open Org → Subscription to see plan status and exam usage.
- Open Org → Billing to upgrade or renew (Paystack yearly billing).
- If you hit a plan limit while creating exams, upgrade in Billing and try again.
Role guide
Teacher
Teachers can create exams, manage questions and subjects, and view results for their organisation.
Teacher access
- Your organisation admin creates a teacher account in Org → Teachers.
- Sign in at Sign in using your teacher email + password.
- You’ll land on the Org dashboard.
What teachers can do
- Create and publish exams from Org → Exams.
- Add and edit questions (form or CSV).
- Manage subjects from Org → Subjects.
- View results from Org → Results.
- Allow reattempts for students who need an extra attempt.
Role guide
Student
Students can start published exams, use text-to-speech to listen to questions, submit answers, and view results.
Student sign in
- Your organisation admin creates your student account in Org → Students.
- Sign in at Sign in with your student email + password.
- You’ll land on My exams.
My exams
- Open Student → My exams.
- Only published exams appear here.
- Click Start exam (or Continue if in progress).
Taking an exam (text-to-speech + voice answers)
You can listen to questions with text-to-speech and answer by selecting an option or speaking the letter (A/B/C/D).
Keyboard shortcuts
- R — Read question aloud
- S — Speak answer
- N — Next / Submit
- When the exam opens, you’ll see the current question and options (A–D).
- To listen: click Read question aloud or press R.
- To answer:
- Select an option (A–D), or
- Click Speak answer (or press S) and say “A”, “B”, “C”, or “D”.
- Click Next to save and move on (shortcut: N).
- On the last question, clicking Submit exam submits your attempt.
- The timer counts down automatically. When time runs out, the exam will auto-submit.
My results
- Open Student → My results.
- Click View result to review your score and correct answers.
- If your organisation allows a reattempt, you’ll be able to start the next attempt from My exams.
Settings
- Open Student → Settings.
- Update your profile details, then save.
Help
Troubleshooting
Quick fixes for the most common issues.
Students can’t see an exam
- Confirm the exam is Published in Org → Exams.
- Confirm the student is in the same organisation.
- Ask the student to refresh Student → My exams after publishing.
Microphone / speech recognition issues
- Use a supported browser: Chrome or Edge works best.
- Allow microphone permission when prompted.
- Speak clearly and say only the letter: “A”, “B”, “C”, or “D”.
- If speech recognition is unavailable, you can still answer by selecting options.
Text-to-speech issues
- Make sure your device audio is on and volume is up.
- Reload the page, then click Read question aloud again.
- If you don’t hear a voice, your device may not have an English voice installed/enabled.
Timer & auto-submit
- The countdown is based on the exam session expiry time; leaving the page does not stop the timer.
- If time runs out, the platform will attempt an automatic submission.
- If submission fails due to network, refresh and try again immediately.
Billing / plan limits
- If you can’t create more exams, check Org → Subscription for exam usage.
- Upgrade or renew in Org → Billing, then try creating the exam again.
Shareable links
You can share direct links to any section on this page. Example: #org-create-exam or #student-taking-exam.
Need help?
If you’re stuck, check the Troubleshooting section above or contact us.