# Quiz

From within a course, you can create a quiz-type step. This allows you to add interactive assessments to your courses to : 

* Engage your members with dynamic interactions. 
* Measure their progress based on their answers. 
* Prepare your users for certification based on their score. 

## Managing a Quiz step

To add a Quiz step: 

* Open edit mode by clicking on `Edit`. 
* Click on `Add a step`. 
* Click on `Add quiz step`. 

A new Quiz step has been created. You can configure it with:

* A title (default: New quiz) - *Required*
* A completion time (default: 0 minutes)
* A description
* Questions via the `Add Question` button - Note: A Quiz step must contain at least one question!

The `Quiz Settings` button allows you to access the quiz settings. A drawer will open:

* Settings section. This section includes:
  * A switch allowing participants to retake the quiz multiple times.
  * A switch allowing you to hide quiz results from participants.
* Score section. This section includes:
  * A switch allowing you to define a minimum passing score required to complete this step.
  * You can set this minimum score as a percentage.
* Question order section. This section displays the list of questions, which you can reorder using drag and drop.

{% hint style="warning" %}
Important: When you define a minimum passing score, members will not be able to complete this step unless they reach the required score. It is therefore recommended to also enable the switch allowing participants to retake the quiz.
{% endhint %}

Please remember to click `Update` to save your changes, or your settings will not be applied.

<figure><img src="/files/wrF0kxqxsfmE3UDCN9Dq" alt=""><figcaption></figcaption></figure>

You can then edit all of these elements from edit mode later! You can also delete this step at any time by clicking on the `X` button in the list of steps.&#x20;

{% hint style="info" %}
Please note that deleting a Quiz type step is irreversible and will delete all the data linked to this quiz!&#x20;
{% endhint %}

## Managing questions in a Quiz step&#x20;

### Adding a question&#x20;

Once you have created a Quiz step, you can add questions from the course edit mode by clicking on the `Add a question` button. A menu opens and you can choose between :&#x20;

* `Single select` (only one correct answer).&#x20;
* `Multiple select` (several possible correct answers).&#x20;

A creation drawer opens. It contains :&#x20;

* A question type (Single selection or Multiple selection)&#x20;
* A title - *Mandatory*&#x20;
* A description&#x20;
* A list of answers:&#x20;
  * By default, 2 answers are created: `Answer 1` and `Answer 2`.&#x20;
  * Add an answer using the `Add an answer` button.&#x20;
  * Reorder the answers using drag and drop.&#x20;
  * Select the correct answer(s) using the boxes to the right of the answers.&#x20;
  * Delete an answer using the `Delete` button to the right of the answer.&#x20;
  * You must have at least 2 answers.
* Additional feedback: you can add a short explanation to clarify the correct answer. This text will only be displayed if the member answered the question incorrectly.
* A `Create` button to save.&#x20;

### Edit a question&#x20;

You can edit a question by clicking on the `Edit` icon at the top right of the question card. From the edit drawer, you can change :&#x20;

* The title and description&#x20;
* The list of answers&#x20;

From this edit drawer, you can also delete the question by clicking on the `Delete` button. Please note that deleting a question is irreversible!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.meltingspot.io/english/spot-content/courses/quiz.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.