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

# Creating Quizzes

> How to create and configure assessments with multiple choice and open-ended questions

## Quizzes and assessments

Create comprehensive assessments to test student knowledge. The platform supports multiple choice questions with automatic grading and open-ended (essay) questions with manual grading by the teacher.

## Creating a quiz

<Steps>
  <Step title="Access the quiz list">
    In the sidebar menu, click **Quizzes**. You will see the list of all existing quizzes with title, linked course, number of questions, and status.
  </Step>

  <Step title="Click New quiz">
    Fill in the basic information: title, description, and select the course the quiz will be linked to.
  </Step>

  <Step title="Configure the rules">
    Set the time limit, number of attempts, minimum passing score, and other behavior options.
  </Step>

  <Step title="Add questions">
    Create multiple choice or open-ended questions. Each question has a point value.
  </Step>

  <Step title="Publish">
    Activate the quiz so students can access it. You can schedule availability for a future date.
  </Step>
</Steps>

## Quiz fields

When creating or editing a quiz, you configure the following fields:

| Field                         | Description                                                  |
| ----------------------------- | ------------------------------------------------------------ |
| **Title**                     | Quiz name displayed to students                              |
| **Description**               | Explanatory text about the assessed content                  |
| **Course**                    | Course the quiz is linked to                                 |
| **Category**                  | Thematic classification of the quiz                          |
| **Difficulty level**          | Easy, medium, or hard                                        |
| **Type**                      | `multipla_escolha`, `resposta_aberta`, or `diversos` (mixed) |
| **Time (minutes)**            | Time limit for completion. Leave empty for no limit          |
| **Minimum correct answers**   | Minimum number of correct answers to pass                    |
| **Maximum attempts**          | How many times the student can retake. Empty for unlimited   |
| **Interval between attempts** | Minimum time in minutes between one attempt and the next     |
| **Show immediate result**     | Whether the student sees the result right after finishing    |

### Scheduling and expiration

You can control when the quiz becomes available:

| Field               | Description                                    |
| ------------------- | ---------------------------------------------- |
| **Quiz open**       | Whether it is currently accessible to students |
| **Scheduled**       | Whether it has a programmed opening date       |
| **Scheduled date**  | When the quiz will be opened automatically     |
| **Expiration date** | When the quiz will be closed automatically     |
| **Tags**            | Labels for organization and search             |

<Info>
  Scheduled quizzes are visible in the student's list with an indication of when they will be available, but cannot be started before the date.
</Info>

## Question types

### Multiple choice

Objective questions with one or more correct alternatives.

For each multiple choice question, you define:

* **Prompt** - Question text (supports rich formatting via Lexical editor)
* **Alternatives** - List of options with text
* **Correct answer(s)** - Mark which alternatives are correct
* **Value** - Question score

Grading is **automatic**: the system compares the student's answers with the answer key and calculates the score immediately.

### Open-ended (essay) questions

Questions that require a written response from the student.

For each open-ended question, you define:

* **Prompt** - Question text (Lexical editor with rich formatting)
* **Value** - Maximum score for the question

Grading is **manual**: the teacher needs to evaluate each response individually, assign a score, and provide feedback.

<Note>
  The prompt editor uses Lexical and stores content as structured JSON, enabling rich formatting with bold, italic, lists, links, and images.
</Note>

### Mixed type (diversos)

Quizzes of type `diversos` allow combining multiple choice and open-ended questions in the same quiz. Objective questions are graded automatically and open-ended questions await manual grading.

## Attempt lifecycle

When a student starts a quiz, the attempt goes through the following states:

```
Start -> In progress -> Finish
                     -> Abandon (timeout or withdrawal)
```

1. **Start** - The student clicks "Start quiz". An attempt is created with status `em_andamento` and the timer begins (if there is a time limit)
2. **Answer** - The student answers the questions. Responses are saved progressively
3. **Finish** - The student clicks "Finish" or time expires. The attempt receives status `finalizado` and the score is calculated
4. **Abandon** - If the student leaves without finishing and time expires, the attempt receives status `abandonado`

<Warning>
  If the quiz has a time limit, the timer continues even if the student closes the browser. Upon returning, the remaining time will be whatever was left.
</Warning>

## Results and statistics

When `mostrar_resultado_imediato` is enabled, after finishing the attempt the student sees:

* **Score obtained** - Total points
* **Total correct** - Number of correct questions (for multiple choice)
* **Ranking position** - Comparison with other students
* **Overall average** - Average of all participants
* **Total participants** - How many students have taken it
* **Accuracy rate per question** - Percentage of correct answers for each question

## Tips for creating good quizzes

<Tabs>
  <Tab title="Multiple choice">
    * Write clear and unambiguous prompts
    * Create plausible alternatives (avoid obviously wrong options)
    * Vary the position of the correct answer
    * Include between 4 and 5 alternatives per question
    * Use the category field to organize questions by topic
  </Tab>

  <Tab title="Open-ended">
    * Define clear evaluation criteria in the prompt
    * Specify what you expect in the response (length, format)
    * Set the question value proportionally to its complexity
    * Consider sharing the evaluation rubric with students
  </Tab>
</Tabs>

<Tip>
  Use quizzes with `intervalo_tentativas_minutos` to encourage studying between attempts. A 24-hour interval (1440 minutes) between attempts encourages students to review the content before trying again.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Grade questions" icon="pen-to-square" href="/en/teachers/grading">
    Evaluate open-ended responses and provide feedback
  </Card>

  <Card title="Analytics" icon="chart-line" href="/en/teachers/analytics">
    View quiz performance metrics
  </Card>
</CardGroup>