> ## Documentation Index
> Fetch the complete documentation index at: https://docs.introw.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Assess learners with a quiz

> Add quiz questions to a course, require a passing score, and review the answers that need a human - end to end.

> For authors who want a course to prove competency, not just present content.

A course that only presents content cannot tell you whether a partner actually learned anything, and a "completed" with no bar behind it is not a signal you can trust when deciding who is ready to sell or deliver. This guide builds a real assessment end to end: add questions that test understanding, set a passing score so completion means something, and review the upload answers that need a human.

## What you'll achieve

A course with quiz questions (multiple-choice, open-ended, and upload), a minimum passing score that gates completion and certification, and a review flow for upload answers that release completion once graded.

## Before you start

<Steps>
  <Step title="Confirm access">
    You need a team role with write access to Courses, and reviewer access to enrollments for grading uploads. For AI grading of open-ended questions, AI features must be enabled for your organisation.
  </Step>

  <Step title="Have a course to assess">
    Have the course built (see [Build a partner course from scratch](../../authoring/guides/build-a-course-manually)) so you have chapters to attach questions to.
  </Step>
</Steps>

## Watch it

<Tabs>
  <Tab title="Video">
    <video controls playsInline preload="none" poster="https://assets.introw.io/docs/features/courses/quizzes/guides/assess-learners-with-a-quiz/steps/01.png?v=1783329843" className="w-full rounded-xl" src="https://assets.introw.io/docs/features/courses/quizzes/guides/assess-learners-with-a-quiz/video.webm?v=1783329843#t=2.5" />
  </Tab>

  <Tab title="Click through">
    <iframe className="w-full rounded-xl" style={{ width: "100%", aspectRatio: "16 / 11", border: 0, backgroundColor: "#FAFAFA" }} src="https://assets.introw.io/docs/features/courses/quizzes/guides/assess-learners-with-a-quiz/walkthrough.html?v=1783329843" />
  </Tab>
</Tabs>

## Steps

### Add quiz questions

<Steps>
  <Step title="Open the chapter to test">
    Open the course from [Courses](https://app.introw.io/courses), enter the builder, and select the chapter where the question belongs. Questions sit inside a chapter's content, so pick the lesson the question should follow.

    <Frame>
      <img src="https://assets.introw.io/docs/features/courses/quizzes/guides/assess-learners-with-a-quiz/steps/01.png?v=1783329843" alt="Open the chapter to test" />
    </Frame>
  </Step>

  <Step title="Insert a quiz and write the prompt">
    Add a quiz in the chapter editor and type the question prompt. Keep each question focused on a single idea so the result is easy to interpret and easy to act on.

    <Frame>
      <img src="https://assets.introw.io/docs/features/courses/quizzes/guides/assess-learners-with-a-quiz/steps/02.png?v=1783329843" alt="Insert a quiz and write the prompt" />
    </Frame>
  </Step>

  <Step title="Choose the question type">
    Pick the type that matches what you are testing:

    * **Multiple choice** - define the options and mark the correct one. Use this for recall and clear right-or-wrong checks; it grades instantly.
    * **Open-ended** - a free-text answer the AI grades against the course material. Use this to test understanding in the learner's own words. Run the preview grader on a sample answer to confirm the AI scores it the way you expect, and refine the prompt or expected answer if it does not.
    * **Upload** - a file or written response a reviewer marks by hand. Use this for applied work like a demo recording or a worked example. Note that a course with upload questions cannot reach **Completed** until every upload is reviewed.

    <Frame>
      <img src="https://assets.introw.io/docs/features/courses/quizzes/guides/assess-learners-with-a-quiz/steps/07.png?v=1783329843" alt="Choose the question type" />
    </Frame>
  </Step>

  <Step title="Save the chapter">
    Save the chapter. The question becomes part of the course and appears the next time you preview it.
  </Step>
</Steps>

### Require a passing score

<Steps>
  <Step title="Open the Advanced tab">
    Select **Configure** to open the **Update course** dialog, then go to the **Advanced** tab, where course-wide rules like the passing score and due date live.
  </Step>

  <Step title="Enable and set the score">
    Set the bar learners must clear:

    * **Minimum score to pass** - turn it on to require a score. It starts at 70%; enter any value from 0 to 100. Choose a bar that reflects how critical the material is: higher for must-get-right topics, lower for general awareness. With a score set, "completed" means the learner demonstrated understanding, and any attached certificate only issues once they pass.
  </Step>

  <Step title="Save changes">
    Select **Save Changes**. The threshold applies going forward, so learners who finish after this point must meet it to pass.
  </Step>
</Steps>

### Review upload answers

<Steps>
  <Step title="Open the learner's enrollment">
    From the course's tracking view, find the learner and open their enrollment detail. The **In progress** tab is usually where learners with pending uploads sit.
  </Step>

  <Step title="Open the submission and grade it">
    Find the upload question, open the submitted file or written response, and assess it against what the question asked for:

    * **Verdict** - mark the answer **correct** or **incorrect**. This feeds the learner's course score.
    * **Reviewer feedback** - optionally add a note (up to 2000 characters) explaining the decision. This is useful when the learner needs to know what to fix.
  </Step>

  <Step title="Save the review">
    Save your review. The learner is notified, the course score updates, and if this was the last unreviewed upload, the enrollment can move to **Completed** (and earn its certificate if the passing score is met).
  </Step>
</Steps>

## Verify it worked

Previewing the course shows each question and learners must answer to progress: open-ended answers receive an AI assessment and upload answers wait for review. Learners who score below the threshold are not marked as passed, a graded upload shows your verdict and feedback, and marking the last outstanding upload lets the enrollment reach **Completed**.

## Related

<CardGroup cols={2}>
  <Card title="Build a partner course from scratch" icon="book-open" href="../../authoring/guides/build-a-course-manually">
    Add the chapters these questions live in.
  </Card>

  <Card title="Create and auto-issue a certificate" icon="award" href="../../certificates/guides/create-a-certificate">
    Reward a passing score with a credential.
  </Card>

  <Card title="Monitor course progress" icon="chart-line" href="../../progress-tracking/guides/monitor-course-progress">
    Track scores and completion across learners.
  </Card>

  <Card title="Implementation reference" icon="screwdriver-wrench" href="../technical">
    Question types, scoring, and review gating.
  </Card>
</CardGroup>
