Built LMS Help Center
Assessments

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:

  1. Runs validation.
  2. Saves unsaved draft changes first.
  3. Creates a version snapshot.
  4. 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 conditionError
Missing exam titleExam title is required
No sectionsExam must have at least one section
Missing section titleSection [number] is missing a title
Question pool selects 0 or fewer questionsQuestion pool "[title]" must select at least 1 question

Current validation warnings include:

Warning conditionWarning
Section has no pools or questionsSection "[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:

  1. Save the draft so the exam has an ID.
  2. Set title, description, instructions, and pre-exam page.
  3. Add at least one section.
  4. Add selected questions, question pools, or both.
  5. Confirm every pool draws at least 1 question.
  6. Configure scoring, timing, attempts, display, media, certificates, security, and AI grading as needed.
  7. Add or verify categories.
  8. Use Preview and resolve validation errors.
  9. Use Test Exam.
  10. Configure the landing page.
  11. Configure enrollments.
  12. Publish.
  13. Confirm the Exams list shows the expected status.

Troubleshooting

On this page