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

# Creating a quiz

> How to create a new quiz from scratch

## Overview

Creating a quiz in Hey Quiz is a simple three-step process:

1. Create the quiz (title, description)
2. Add questions
3. Configure settings

<Info>
  You can also [generate quizzes with AI](/en/ai/generator) or [import from file](/en/quizzes/import-export).
</Info>

## Creating a new quiz

<Steps>
  <Step title="Go to My quizzes panel">
    After logging in, click **"My quizzes"** in the top navigation menu.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/heyquiz/images/en/dashboard-menu.png" alt="Navigation menu" />
    </Frame>
  </Step>

  <Step title="Click Create Quiz">
    In the top right corner you'll find the **"+ Create Quiz"** button.

    Alternatively you can:

    * **Generate with AI** - automatic creation from topic
    * **Import** - load quiz from JSON or Excel
  </Step>

  <Step title="Fill in the form">
    | Field           | Required | Description                       |
    | --------------- | -------- | --------------------------------- |
    | **Title**       | Yes      | Quiz name visible to participants |
    | **Description** | No       | Short topic description           |
    | **Language**    | Yes      | Quiz interface language           |
  </Step>

  <Step title="Save quiz">
    Click **"Create"** - you'll be redirected to the quiz editor.
  </Step>
</Steps>

## Adding questions

### Step by step

<Steps>
  <Step title="Click Add question">
    In the quiz editor, click the **"+ Add question"** button.
  </Step>

  <Step title="Choose question type">
    Hey Quiz offers 9 question types:

    <CardGroup cols={3}>
      <Card title="Single choice" icon="circle-dot" href="/en/questions/single-choice">
        One correct answer
      </Card>

      <Card title="Multiple choice" icon="square-check" href="/en/questions/multiple-choice">
        Several correct answers
      </Card>

      <Card title="True/False" icon="scale-balanced" href="/en/questions/true-false">
        Binary question
      </Card>

      <Card title="Ordering" icon="arrow-down-1-9" href="/en/questions/ordering">
        Arrange in correct order
      </Card>

      <Card title="Raise hand" icon="hand" href="/en/questions/raise-hand">
        Verbal answer
      </Card>

      <Card title="Poll" icon="chart-pie" href="/en/questions/poll">
        Collect opinions
      </Card>

      <Card title="Fill in blank" icon="font" href="/en/questions/fill-blank">
        Type the answer
      </Card>

      <Card title="Match" icon="puzzle-piece" href="/en/questions/match">
        Fill from dropdown
      </Card>

      <Card title="Open-ended" icon="comment" href="/en/questions/open-ended">
        Free text response
      </Card>
    </CardGroup>
  </Step>

  <Step title="Enter question text">
    Write clear and unambiguous question text.

    <Tip>
      **Best practices:**

      * Avoid ambiguity
      * Question should be understandable without additional context
      * Don't use double negatives
    </Tip>
  </Step>

  <Step title="Add answers">
    Depending on question type:

    * **Single/Multiple choice**: Add min. 2 answers, mark correct ones
    * **True/False**: Select the correct option
    * **Ordering**: Add elements in correct order
    * **Fill in blank**: Place answer in `{braces}` in the text

    Details in each [question type](/en/questions/overview) documentation.
  </Step>

  <Step title="Configure parameters">
    | Parameter       | Default | Range   | Description        |
    | --------------- | ------- | ------- | ------------------ |
    | **Time**        | 20s     | 5-300s  | Time to answer     |
    | **Points**      | 1000    | 0-10000 | Maximum points     |
    | **Explanation** | -       | text    | Shown after answer |
  </Step>
</Steps>

## Question order

### Reordering

Questions can be rearranged using **drag and drop**:

1. Hover over the **⋮⋮** icon (six dots) on the left side of the question
2. Hold and drag to new position
3. Drop - order is saved automatically

### Numbering

Questions are automatically numbered from 1. After reordering, numbering updates automatically.

## Saving the quiz

<Warning>
  **Remember to save!** Changes are not saved automatically. Click **"Save"** after each editing session.
</Warning>

## Common issues

<AccordionGroup>
  <Accordion title="Cannot add more questions">
    Check your plan's question limit. Free accounts allow 10 questions per quiz.
  </Accordion>

  <Accordion title="Quiz won't save">
    * Check your internet connection
    * Make sure title is not empty
    * Try refreshing the page and saving again
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Editing quizzes" icon="pen-to-square" href="/en/quizzes/editing">
    Modify existing quizzes
  </Card>

  <Card title="Quiz settings" icon="gear" href="/en/quizzes/settings">
    Scoring modes, randomization, teams
  </Card>

  <Card title="Cover image" icon="image" href="/en/quizzes/cover-image">
    Add an attractive cover
  </Card>

  <Card title="Start session" icon="play" href="/en/sessions/starting">
    Begin quiz with participants
  </Card>
</CardGroup>