# Course quizzes: check what students learned

> Make short quizzes that check what students learned, then put them in a course.

Source: https://docs.personacart.com/commerce/quizzes

In short: {"Make short quizzes that check what students learned, then put them in a course."}

A quiz is a few short questions that check what a student learned. A quiz does nothing until it sits in a course: put it at the end of a module, or as the course's final test. Passing a quiz can also be what earns a [certificate](/commerce/certificates).

Video: How to check which quizzes need attention (https://www.youtube.com/watch?v=581zYlmUETU)

Quizzes, like [courses](/commerce/curriculum) and certificates, are included from the Starter plan, and the number of quizzes is not limited.

1. Open **Commerce → Curriculum → Quizzes** and press **Make a quiz**.
2. Name it and pick a pass mark, then add questions.
3. Publish it, then attach it to a course.

## Where to find it

Sidebar → COMMERCE → Curriculum → Quizzes.

## The quiz list

Each quiz shows its name, number of questions, pass mark, how many attempts students made, the pass rate, the status and where it is placed ("In: Course > Module", or **Not attached**).

- **Layout**: **All quizzes** (a flat list) or **By course** (grouped by course and module). Quizzes that are in no course sit under **Not in any course**: students cannot reach them until you place them.
- **Search quizzes** by name.
- **Status chips**: **All**, **Published**, **Draft**, **Archived**.
- **Special views**: **One question only**, **Hard (under 45% pass)**, **No attempts**, **Not attached**.
- **Sort**: Newest first, Alphabetical, Most attempts, Lowest pass rate, Recently edited.
- **Saved views**: save a combination as a named view for one-tap return.
- Counts at the top: **Total Quizzes**, **Published**, **Drafts**, **Unlinked**.

### Needs you

A **Needs you** strip counts quizzes that deserve a look and filters the list when you press its button. Nothing is changed until you act.

| Line | Why it matters |
|---|---|
| Quizzes with only one question | A one-question quiz cannot tell a pass from a lucky guess. |
| Quizzes where fewer than 45% pass | At least 5 attempts and under 45% passing. Students may fail, ask for refunds and stop at the quiz. Open **Results** to see the questions they miss most. |
| Quizzes nobody has taken yet | Share the course, or check that the quiz is attached to one. |
| Quizzes not in any course | A quiz outside a course never counts toward finishing it. |

### Row actions and bulk actions

- **Open** edits the quiz; **Results** shows how students did.
- The **⋯** menu: **Duplicate**, **Assign to module** (put it in a course), **Unassign from module** and **Delete**.
- Tick several quizzes and use **Publish**, **Duplicate** or **Archive** from the bulk bar. You see how many changed and how many were skipped, with **Undo**.

## Make a quiz

Press **Make a quiz** (shown as **Create Quiz** on some screens).

1. **Name your quiz.** Students see this name, for example "Free throw rules check".
2. **How many answers must be right to pass?** Choose **Easy: 50 out of 100** (good for fun checks), **Normal: 70 out of 100** (most coaches pick this) or **Strict: 90 out of 100** (for safety or rules). You can change the exact number later.
3. Press **Make quiz and add questions**. A new quiz appears in your list; students cannot see it until you put it in a course.

## The quiz builder

The builder has the **question list** on the left, the **selected question** on the right and **Quiz settings** above.

### Quiz settings

"Five things, all read when a student takes the quiz."

| Setting | What it does |
|---|---|
| **Pass mark** | The minimum score (0 to 100) a student must reach to pass. |
| **Time limit** | Minutes the student has to finish (1 to 600). Empty means no time limit. |
| **Tries allowed** | How many times a student may take it (1 to 100). Empty means **Unlimited**. You can give one student extra tries from the course's Students tab. |
| **Shuffle questions** | Shows the questions in a random order. |
| **Shuffle answers** | Shows the answer options of each question in a random order. |

The quiz also has a **title** and **tags** (your own labels).

### Questions

Press **Add question** and fill in:

| Field | What it does |
|---|---|
| **Question Text** | The question. Required to publish. |
| **Type** | **Multiple Choice**, **True/False**, **Short Answer** or **Fill in the Blank**. |
| **Points** | How much the question is worth. New questions start at 1 point. |
| **Options** | For Multiple Choice and True/False: the answer choices, with one marked **Correct**. Multiple Choice allows 2 to 10 options; add, remove and reorder them. |
| **Expected Answer Keywords** | For Short Answer: keywords separated by commas. |
| **Accepted Answers** | For Fill in the Blank: type three underscores (___) where the blank goes, for example "The capital of France is ___.", then list the accepted answers separated by commas. Matching ignores upper and lower case. An exact match earns full credit; a partial match (part of the answer) earns half. |

Reorder questions with the arrows next to each one; delete a question with its bin icon. **Preview** shows the quiz the way a student sees it (add at least one question first). **AI Generate** asks Pie to write more questions; questions already in the quiz are not added twice.

### Module assignment

The builder shows where the quiz sits (**Module Assignment**) and lets you **Unassign from this module**, or **Assign to module**.

### Save and publish

- **Save** keeps your work. A badge says **Unsaved** when you have changes.
- **Publish** makes the quiz visible to enrolled students after a check. The check lists anything to fix: the quiz needs at least one question; every question needs text; Multiple Choice and True/False need at least two options and a correct answer; no empty options.
- After you change a published quiz, **Publish update** saves a new published version. Learners who take the quiz after that see your latest questions and scoring. **Anyone who already finished an attempt keeps their original result**; publishing never changes a score already graded.

:::note[Drafts, results and deleting]
- Published quizzes only appear in the "Attach quiz" list inside a course. Drafts are listed as hidden until published.
- The Results page leaves out earlier attempts made before you last edited the questions, so the numbers stay fair.
- Deleting a quiz that sits in a course also removes it from there. "Take it out of the course" keeps the quiz and lets you use it again.
:::

## Put a quiz in a course

From the list, pick **Assign to module** (or **Put it in a course**):

1. **Which course?** Choose the course.
2. **After which part?** Pick the module, or **At the very end, as the final test**.
3. Press **Put it there**.

- The panel says how many students are in that course and will see the quiz; students who already finished that part are not forced to go back.
- You can take the quiz out again and it is not deleted.
- You can also attach a quiz from inside a course: in the Content tab press **Add quiz** on a module, or use the course's **Finish & certificate** tab for the final quiz.
- See [Finish, release and prerequisites](/commerce/course-settings).

## Results

Press **Results** on a quiz. You see:

- **Attempts**, **Students**, **Pass rate** and **Average score**, and the date of the last attempt.
- **Most-missed questions** with the share of attempts that got each wrong (for example "62% missed (31 of 50)").
- **Scores**: how scores spread across ranges.

For a single student's attempts open the course's Students tab; see [Course students and access](/commerce/course-students).

## Questions
