Preview and Publish Exams
Save drafts, preview exams, resolve validation, publish or republish, manage versions, enrollments, and exam landing pages.
Use Preview and publishing workflows when exam structure and settings are ready to test or launch.
Before you begin
Save the exam draft so it has an ID. Preview player, enrollments, landing page, certificate association, and version history all depend on a saved exam.
Before publishing, confirm sections, questions, pools, settings, landing page, and enrollment plan are ready for learners.
Save and preview
Save drafts
Select Save Draft to persist changes without making them live.
Saving:
- Creates the exam row for a new in-memory draft.
- Uploads a changed thumbnail.
- Sets status to draft.
- Increments draft change count.
- Leaves learners on the current published version until you publish or republish.
If you leave with unsaved changes, the builder prompts:
You have unsaved changes. Are you sure you want to leave?
Preview the exam
Open Preview in the builder header.
The builder preview:
- Runs publish validation.
- Shows whether the exam is ready to publish.
- Shows exam title, description, instructions, status, question count, minutes, and section count.
- Lists validation errors and warnings.
- Shows section previews.
- Samples questions from question pools.
- Enables Test Exam only when validation passes and the exam has an ID.
Use Test Exam to launch the exam player in preview mode. Preview attempts do not create normal learner attempts.
Publish or republish
Publish changes
Use Publish for a new live exam. Use Republish when an already published exam has draft changes.
Publishing:
- Runs validation.
- Saves unsaved draft changes first.
- Creates a version snapshot.
- Makes the exam live.
The confirmation dialog says learners will be able to take a newly published exam. For republishing, it says draft changes become live and learners see the updated exam.
Resolve publish validation
Publishing is blocked when validation errors exist.
Current validation errors include:
| Error condition | Error |
|---|---|
| Missing exam title | Exam title is required |
| No sections | Exam must have at least one section |
| Missing section title | Section [number] is missing a title |
| Question pool selects 0 or fewer questions | Question pool "[title]" must select at least 1 question |
Current validation warnings include:
| Warning condition | Warning |
|---|---|
| Section has no pools or questions | Section "[title]" has no question pools or questions |
Warnings do not block publishing, but they should usually be resolved before a real launch.
Manage published exam work
Versions
Open Versions to review snapshots.
The Versions view includes version history, compare versions, current/published status badges, Create Version, version preview, restore actions, and delete actions for non-current versions.
Publishing also creates a version snapshot. Use manual versions before large edits when you want a named checkpoint.
Enrollments
Open Enrollments to manage learner access.
If the current route is /exam-edit/new, the view shows:
Save the exam first to manage enrollments.
Save the exam draft first, then return to Enrollments.
Landing page
Use Landing Page in the builder header to configure the learner-facing exam detail page:
/admin-dashboard/exams/[id]/layout
The landing page is separate from the exam-taking interface. Use it to explain purpose, timing, scoring, instructions, attempts, prerequisites, or policies before learners start.
See Landing Page Editor Basics.
Verify and support publishing
Verify success before publishing
Before publishing:
- Save the draft so the exam has an ID.
- Set title, description, instructions, and pre-exam page.
- Add at least one section.
- Add selected questions, question pools, or both.
- Confirm every pool draws at least 1 question.
- Configure scoring, timing, attempts, display, media, certificates, security, and AI grading as needed.
- Add or verify categories.
- Use Preview and resolve validation errors.
- Use Test Exam.
- Configure the landing page.
- Configure enrollments.
- Publish.
- Confirm the Exams list shows the expected status.
Troubleshooting
Check the validation badge and open Preview. Fix validation errors first. Common blockers are missing title, no sections, missing section title, or a pool set to draw 0 questions.
Open the validation card in Preview and fix each error. Warnings should be reviewed even when publishing is allowed.
The test player requires a saved exam ID and a valid exam. Save the draft and resolve validation errors.
Draft changes are not live until Publish or Republish completes. Save the draft, then republish.