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

# Creating Quizzes

> How to create quizzes, add multiple-choice questions (with math support), configure settings, and view results on Lena.

Quizzes on Lena are multiple-choice (MCQ) assessments that are automatically
graded. You create the questions, set the correct answers, and Lena handles the
scoring.

<Note>
  **Before you begin:** You need an existing course. See [Creating a
  Course](/teachers/creating-a-course).
</Note>

***

## Creating a new quiz

<Steps>
  <Step title="Open your course">
    Navigate to the course and go to the **Quizzes** section. You'll see any existing quizzes listed here.
  </Step>

  <Step title="Tap 'Create Quiz'">
    Start building your quiz. The quiz creation form appears.
  </Step>

  <Step title="Fill in quiz details">
    | Field                 | Description                                                                    |
    | --------------------- | ------------------------------------------------------------------------------ |
    | **Title**             | Quiz name (e.g., "Chapter 3 Quiz", "Midterm Practice Quiz")                    |
    | **Description**       | Instructions or notes for students                                             |
    | **Duration**          | Time limit in minutes (leave blank for untimed)                                |
    | **Max attempts**      | How many times a student can take the quiz                                     |
    | **Shuffle questions** | Randomize question order for each student                                      |
    | **Graded**            | Whether this quiz counts toward the course grade                               |
    | **Show results**      | When students can see their results (immediately, after deadline, or manually) |

    <Frame caption="Screenshot: Quiz creation form with title, duration, and settings">
      <img className="block dark:hidden" src="https://mintcdn.com/lenaafrica/ISsABwDXCBX0o69d/images/placeholder-light.png?fit=max&auto=format&n=ISsABwDXCBX0o69d&q=85&s=8aa659c894fa0cbcd69dca2937f31d5d" alt="Quiz creation form with fields for title, description, duration, max attempts, and settings toggles" width="1600" height="938" data-path="images/placeholder-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/lenaafrica/ISsABwDXCBX0o69d/images/placeholder-dark.png?fit=max&auto=format&n=ISsABwDXCBX0o69d&q=85&s=d8ebf01c18a25cc2bcf05b022a7d47a1" alt="Quiz creation form with fields for title, description, duration, max attempts, and settings toggles" width="1600" height="938" data-path="images/placeholder-dark.png" />
    </Frame>
  </Step>
</Steps>

***

## Adding questions

After creating the quiz, add your questions:

<Steps>
  <Step title="Tap 'Add Question'">
    Open the question editor. You'll see a form with fields for the question text, answer options, and marks.
  </Step>

  <Step title="Write the question text">
    Type your question. You can format it with markdown (for bold, lists, headings, etc.) for emphasis, lists, or code blocks.

    <Frame caption="Screenshot: Question editor with question text and options">
      <img className="block dark:hidden" src="https://mintcdn.com/lenaafrica/ISsABwDXCBX0o69d/images/placeholder-light.png?fit=max&auto=format&n=ISsABwDXCBX0o69d&q=85&s=8aa659c894fa0cbcd69dca2937f31d5d" alt="Question editor with text input for the question, multiple-choice options A through D, and marks field" width="1600" height="938" data-path="images/placeholder-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/lenaafrica/ISsABwDXCBX0o69d/images/placeholder-dark.png?fit=max&auto=format&n=ISsABwDXCBX0o69d&q=85&s=d8ebf01c18a25cc2bcf05b022a7d47a1" alt="Question editor with text input for the question, multiple-choice options A through D, and marks field" width="1600" height="938" data-path="images/placeholder-dark.png" />
    </Frame>
  </Step>

  <Step title="Add answer options">
    Enter the answer options (A, B, C, D, etc.). Each option has:

    * **Option letter** (A, B, C, D)
    * **Option text** — the answer choice
  </Step>

  <Step title="Select the correct answer">
    Mark which option is the correct answer. The selected option is highlighted.
  </Step>

  <Step title="Set marks">
    Enter how many marks this question is worth (e.g., 1, 2, 5).
  </Step>

  <Step title="Save and continue">
    Save the question and add more, or finish when done. Each saved question appears in your quiz's question list.
  </Step>
</Steps>

***

## Math editor

For math and science quizzes, Lena includes a **math equation editor** that lets
you add formatted equations to your questions and answer options.

<Frame caption="Screenshot: Math equation editor showing a formatted equation being added to a quiz question">
  <img className="block dark:hidden" src="https://mintcdn.com/lenaafrica/ISsABwDXCBX0o69d/images/placeholder-light.png?fit=max&auto=format&n=ISsABwDXCBX0o69d&q=85&s=8aa659c894fa0cbcd69dca2937f31d5d" alt="Math equation editor interface showing a formatted equation being inserted into a quiz question" width="1600" height="938" data-path="images/placeholder-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/lenaafrica/ISsABwDXCBX0o69d/images/placeholder-dark.png?fit=max&auto=format&n=ISsABwDXCBX0o69d&q=85&s=d8ebf01c18a25cc2bcf05b022a7d47a1" alt="Math equation editor interface showing a formatted equation being inserted into a quiz question" width="1600" height="938" data-path="images/placeholder-dark.png" />
</Frame>

Use the math editor to write:

* Fractions, exponents, and square roots
* Greek letters and mathematical symbols
* Complex equations and expressions
* Chemical formulas

<Tip>
  The math editor makes your questions look professional and is much easier to
  read than typing equations as plain text (e.g., "√(x²+y²)" vs a properly
  rendered equation).
</Tip>

***

## Quiz settings explained

### Duration

If you set a duration (e.g., 30 minutes), the timer starts when the student
begins the quiz and counts down. When time runs out, the quiz is auto-submitted
with whatever answers the student has selected.

Leave the duration blank for an **untimed quiz** — students can take as long as
they need.

### Graded vs practice

| Type                      | Effect                                                                                                  |
| ------------------------- | ------------------------------------------------------------------------------------------------------- |
| **Graded**                | The quiz score contributes to the student's quiz average, which factors into their overall course grade |
| **Practice (not graded)** | The quiz is for learning only and does not affect grades                                                |

### Show results

| Setting            | When students see results                 |
| ------------------ | ----------------------------------------- |
| **Immediately**    | Right after submitting                    |
| **After deadline** | After the quiz availability window closes |
| **Manual**         | When you choose to publish results        |

<Tip>
  Use "After deadline" for graded quizzes to prevent students from sharing
  answers before everyone has taken the quiz.
</Tip>

### Shuffle questions

When enabled, each student sees questions in a different random order. This
reduces the ability to copy answers from a neighbor.

### Scoring for multiple attempts

If you allow multiple attempts, the student's grade is based on their **most
recent attempt**. Students can see scores from all their attempts.

***

## Viewing quiz results

After students complete the quiz:

1. Open the quiz from your course
2. Go to the **Results** or **Submissions** section
3. You'll see:
   * Each student's **score** and **percentage**
   * **Time taken** for each attempt
   * An overview of class performance

<Frame caption="Screenshot: Quiz results showing student scores, percentages, and time taken">
  <img className="block dark:hidden" src="https://mintcdn.com/lenaafrica/ISsABwDXCBX0o69d/images/placeholder-light.png?fit=max&auto=format&n=ISsABwDXCBX0o69d&q=85&s=8aa659c894fa0cbcd69dca2937f31d5d" alt="Quiz results table showing student names, scores, percentages, and time taken for each attempt" width="1600" height="938" data-path="images/placeholder-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/lenaafrica/ISsABwDXCBX0o69d/images/placeholder-dark.png?fit=max&auto=format&n=ISsABwDXCBX0o69d&q=85&s=d8ebf01c18a25cc2bcf05b022a7d47a1" alt="Quiz results table showing student names, scores, percentages, and time taken for each attempt" width="1600" height="938" data-path="images/placeholder-dark.png" />
</Frame>

### Reviewing individual answers

Tap a student's result to see their individual answers — which questions they
got right, which they got wrong, and what they selected.

***

## Managing quizzes

* **Edit** — Update questions, settings, or add new questions
* **Delete** — Remove a quiz (this removes all associated questions and results)

<Warning>
  Editing a quiz after students have started taking it may cause
  inconsistencies. If you need to make changes, consider creating a new quiz
  instead.
</Warning>

***

## Troubleshooting

<Accordion title="Quiz won't publish">
  * Make sure you've added at least **one question** to the quiz - Check that
    every question has a **correct answer** selected - Verify the duration is
    set to a valid number of minutes
</Accordion>

<Accordion title="Students report seeing the wrong questions">
  * If **shuffle questions** is enabled, each student sees questions in a
    different order — this is expected - Check the question list in the quiz
    editor to verify the content is correct - If you edited questions after some
    students started, their version may differ
</Accordion>

<Accordion title="Math equations aren't displaying correctly">
  * Preview the question using the **Preview** feature before publishing -
    Make sure the equation was entered using the **math editor**, not typed as
    plain text - Ask students to try a different browser if rendering issues
    persist
</Accordion>

***

## Related guides

* [Taking Quizzes (Student View)](/students/taking-quizzes) — see what students
  experience
* [Grades Overview](/teachers/grades-overview) — see quiz scores in the overall
  grade
* [Creating an Exam (CBT)](/cbt/creating-an-exam) — create secure CBT exams
  (different from course quizzes)
