> For the complete documentation index, see [llms.txt](https://helpdesk.ldtsoft.work/ldt-online-course/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdesk.ldtsoft.work/ldt-online-course/quizzes-and-certificates/how-to-set-up-a-quiz.md).

# How to set up a quiz in a lesson

Choose how many questions a quiz shows, whether answers shuffle, how many attempts students get and what they see afterwards

A quiz block asks the questions; these settings decide how it behaves — how much of the pool each student sees, how often they may retry, and what they learn from the result.

Add the block first, then open it in **Contents** whenever you want to change the rules.

### 1. Add the Quiz block

In the lesson editor, open **Contents** and click **Add new content**, then tick **Quiz / tests** (1) and click **Add**. The quiz editor opens with the settings below.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-d53b4ea1ddb1ce6d580314a2f0f389d4dd8eb9d0%2Fhow-to-set-up-a-quiz-step-1.png?alt=media" alt="Choosing the Quiz / tests block in the lesson content menu"><figcaption></figcaption></figure>

### 2. Decide how much of the quiz a student sees

Under the first group you set **Questions shown per attempt** — leave it empty to show every question, or cap it so each attempt draws a different part of the pool — and then switch on **Shuffle questions** (2) and **Shuffle answers** when the order should change between students.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-3b6ca2507033e50eb774191ee6b7cdf5b843e33e%2Fhow-to-set-up-a-quiz-step-2.png?alt=media" alt="Setting questions per attempt and the two shuffle options"><figcaption></figcaption></figure>

### 3. Set the attempts and the time

In **Attempts & time**, **Maximum attempts** (3) takes a number: `0` means one attempt with no retake, an empty field means unlimited retakes. **Limit time to complete the quiz** puts a clock on the attempt.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-dd98f60af1ea780d14bb8b10e6a5ff9d5153c021%2Fhow-to-set-up-a-quiz-step-3.png?alt=media" alt="Setting the maximum attempts and the time limit of a quiz"><figcaption></figcaption></figure>

### 4. Say whether passing is required

In **Passing requirements**, **Students must pass this quiz to complete the lesson** (4) ties the lesson's completion to the quiz: without a pass, the next lesson stays locked behind the *Require student to complete before next* option of the lesson.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-0bc9d3fb6b8da74333271ee72cfc66ba8d09d4a1%2Fhow-to-set-up-a-quiz-step-4.png?alt=media" alt="Requiring a pass before the lesson counts as complete"><figcaption></figcaption></figure>

### 5. Choose what students see afterwards

In **Results & feedback**, **Show results immediately after each question** (5) tells them whether the answer they just gave was right; **Allow students to view a results summary** lets them reopen a summary of their answers and scores after submitting. Both carry their own explanation under the switch.

<figure><img src="https://3532245007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRJ3j93eHyen8t2flj5y%2Fuploads%2Fgit-blob-de0db1bb651bec0e57fb5e8f479eaddb421c94aa%2Fhow-to-set-up-a-quiz-step-5.png?alt=media" alt="Choosing the feedback a student sees after answering"><figcaption></figcaption></figure>

Save the lesson from the top bar, and the questions themselves are added inside the block, one by one.

### Result

The quiz behaves as you set it: the number of questions per attempt, their order, the retakes and the clock, whether a pass is needed, and what the student is told while answering and after submitting.

### Troubleshooting

* **Students can retake endlessly.** **Maximum attempts** is empty; put `0` there for a single attempt or a number for a fixed number of retakes.
* **The lesson never completes.** **Students must pass this quiz to complete the lesson** is on and the student has not reached the pass score.
* **The quiz ends before students finish.** **Limit time to complete the quiz** is on — check the value, or turn it off for an untimed quiz.
* **Every student sees the same order.** **Shuffle questions** and **Shuffle answers** are off.
* **Students cannot see what they got wrong.** **Show results immediately after each question** and **Allow students to view a results summary** are the two switches that control it.

### Related pages

* [How to add content to a lesson](https://helpdesk.ldtsoft.work/ldt-online-course/build-your-course/how-to-add-content-to-a-lesson.md)
* [How to Review and Grade Student Quizzes and Tests](https://helpdesk.ldtsoft.work/ldt-online-course/quizzes-and-certificates/how-to-review-and-grade-student-quizzes-and-tests.md)
* [How to see quiz and survey analytics](https://helpdesk.ldtsoft.work/ldt-online-course/quizzes-and-certificates/how-to-see-quiz-and-survey-analytics.md)
