Built LMS Help Center
Assessments

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

TaskUse this guide
Understand routes, views, first-save behavior, and the builder workspaceThis page
Add sections, question pools, selected questions, content pages, and reorder exam itemsBuild Exam Structure
Configure title, instructions, scoring, timing, attempts, display, media, certificates, security, and AI gradingConfigure Exam Settings
Save drafts, preview the exam, publish, republish, use versions, manage enrollments, and configure the landing pagePreview and Publish Exams
Create and maintain reusable questionsQuestion Banks
Create rubrics for manual or AI-assisted gradingRubrics and Surveys

Get oriented in Exam Builder

Open the builder

The builder opens at:

RouteUse
/exam-edit/newStart a new draft in memory. No exam row exists until the first save.
/exam-edit/[id]Edit an existing exam.
/exam-edit/[id]?view=previewOpen the builder preview view.
/exam-edit/[id]?view=versionsOpen version history.
/exam-edit/[id]?view=enrollmentsOpen exam enrollments.

Understand builder areas

The builder has three main areas.

AreaWhat it does
HeaderBack to Exams, view switcher, Landing Page, Save Draft, Publish or Republish, validation and unsaved badges.
SidebarTools and question banks. Hidden on smaller screens behind Question Banks.
CanvasExam settings summary, sections, questions, pools, content pages, and section actions.

The header view switcher includes:

ViewUse
EditorBuild sections and configure settings.
PreviewValidate and test the exam flow.
VersionsView, create, preview, compare, restore, or delete snapshots.
EnrollmentsManage 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:

  1. Open Assessments > Exams.
  2. Select New Exam, or open /exam-edit/new.
  3. Add the basic exam details.
  4. Select Save Draft.
  5. Continue editing after the route changes to /exam-edit/[id].

Most exams should be built in this order:

  1. Save the exam draft.
  2. Add sections.
  3. Select a section.
  4. Add question pools, selected questions, or content pages.
  5. Reorder items.
  6. Configure exam settings.
  7. Save the draft.
  8. Preview and resolve validation errors.
  9. Test the exam.
  10. Configure enrollments and the landing page.
  11. 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

On this page