Exam Builder
Choose the right exam builder guide for structure, settings, preview, publishing, versions, enrollments, and landing pages.
Use Exam Builder to build the structure and behavior of an exam. The builder is where you add sections, choose questions, configure timing/scoring/security, preview the learner flow, manage versions, manage enrollments, open the landing page editor, and publish.
Before you begin
You need admin access to exams for your organization.
Before building, prepare:
- Exam title and description.
- Instructions or a pre-exam page if learners need terms, rules, or context.
- Question banks, unless you only plan to add existing individual questions.
- Rubrics for questions that need manual or AI-assisted grading.
- Timing, attempt, scoring, and review policy decisions.
- Certificate requirements, if passing the exam should issue a certificate.
- Enrollment plan.
Choose the right Exam Builder guide
| Task | Use this guide |
|---|---|
| Understand routes, views, first-save behavior, and the builder workspace | This page |
| Add sections, question pools, selected questions, content pages, and reorder exam items | Build Exam Structure |
| Configure title, instructions, scoring, timing, attempts, display, media, certificates, security, and AI grading | Configure Exam Settings |
| Save drafts, preview the exam, publish, republish, use versions, manage enrollments, and configure the landing page | Preview and Publish Exams |
| Create and maintain reusable questions | Question Banks |
| Create rubrics for manual or AI-assisted grading | Rubrics and Surveys |
Get oriented in Exam Builder
Open the builder
The builder opens at:
| Route | Use |
|---|---|
/exam-edit/new | Start a new draft in memory. No exam row exists until the first save. |
/exam-edit/[id] | Edit an existing exam. |
/exam-edit/[id]?view=preview | Open the builder preview view. |
/exam-edit/[id]?view=versions | Open version history. |
/exam-edit/[id]?view=enrollments | Open exam enrollments. |
Understand builder areas
The builder has three main areas.
| Area | What it does |
|---|---|
| Header | Back to Exams, view switcher, Landing Page, Save Draft, Publish or Republish, validation and unsaved badges. |
| Sidebar | Tools and question banks. Hidden on smaller screens behind Question Banks. |
| Canvas | Exam settings summary, sections, questions, pools, content pages, and section actions. |
The header view switcher includes:
| View | Use |
|---|---|
| Editor | Build sections and configure settings. |
| Preview | Validate and test the exam flow. |
| Versions | View, create, preview, compare, restore, or delete snapshots. |
| Enrollments | Manage learner access for the exam. |
The header also shows the exam title, validation counts, Unsaved badge, Save Draft, and Publish or Republish.
Save a new exam first
Opening /exam-edit/new creates an in-memory draft only. It does not create a
database row until you save.
This matters because some features require a saved exam ID:
- Enrollments.
- Landing page layout.
- Certificate association.
- Full preview player.
- Version history.
For a new exam:
- Open Assessments > Exams.
- Select New Exam, or open
/exam-edit/new. - Add the basic exam details.
- Select Save Draft.
- Continue editing after the route changes to
/exam-edit/[id].
Recommended build order
Most exams should be built in this order:
- Save the exam draft.
- Add sections.
- Select a section.
- Add question pools, selected questions, or content pages.
- Reorder items.
- Configure exam settings.
- Save the draft.
- Preview and resolve validation errors.
- Test the exam.
- Configure enrollments and the landing page.
- Publish.
Verify and support the builder
Verify success
You are ready to continue from the builder overview when:
- The exam has a saved ID.
- You know which builder view owns the task.
- Question banks and rubrics exist when the exam needs them.
- The next task is clear: structure, settings, preview/publish, enrollments, or landing page setup.
Troubleshooting
Save the exam first. New exams opened at /exam-edit/new do not have a real
exam ID until first save.
The Landing Page action appears when the exam has an ID. Save the draft first.
There are no unsaved changes. Make a change, such as editing settings or adding content, and the Unsaved badge should appear.