> ## 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.

# Import and export

> How to import quizzes from files and export for reuse

## Overview

Hey Quiz supports import and export in formats:

* **JSON** - full quiz structure
* **Excel (XLSX)** - spreadsheet

## Importing a quiz

### From JSON file

<Steps>
  <Step title="Go to import">
    In **My quizzes** panel, click **"Import"**.
  </Step>

  <Step title="Select JSON file">
    Click **"Choose file"** and select `.json` file.
  </Step>

  <Step title="Review preview">
    System will show quiz preview:

    * Title
    * Question count
    * Question types
  </Step>

  <Step title="Import">
    Click **"Import"** - quiz will appear in list.
  </Step>
</Steps>

### From Excel file

<Steps>
  <Step title="Prepare Excel file">
    Spreadsheet structure:

    | Column | Content                                              |
    | ------ | ---------------------------------------------------- |
    | A      | Question text                                        |
    | B      | Question type (single/multiple/true\_false/ordering) |
    | C      | Answer 1                                             |
    | D      | Answer 2                                             |
    | E      | Answer 3                                             |
    | F      | Answer 4                                             |
    | G      | Correct answers (e.g., "1" or "1,3")                 |
    | H      | Time (seconds)                                       |
    | I      | Points                                               |
  </Step>

  <Step title="Import file">
    Select `.xlsx` file in import dialog.
  </Step>

  <Step title="Map columns">
    If structure differs, map columns to appropriate fields.
  </Step>

  <Step title="Review and import">
    Check preview and click **"Import"**.
  </Step>
</Steps>

<Info>
  **Excel template**: Download [Excel template](/files/quiz-template.xlsx) with sample data.
</Info>

### Supported question types for import

| Type in file | Type in Hey Quiz |
| ------------ | ---------------- |
| `single`     | Single choice    |
| `multiple`   | Multiple choice  |
| `true_false` | True/False       |
| `ordering`   | Ordering         |

<Warning>
  Types **Raise hand**, **Poll**, **Fill in blank**, **Match**, and **Open-ended** are not currently supported for import. Add them manually after import.
</Warning>

## Exporting a quiz

### To JSON

<Steps>
  <Step title="Find quiz">
    In **My quizzes** panel, find quiz to export.
  </Step>

  <Step title="Click Export">
    Click **"Export"** button next to quiz.
  </Step>

  <Step title="Choose format">
    Select **JSON** from format list.
  </Step>

  <Step title="Download file">
    File will download automatically.
  </Step>
</Steps>

### To Excel

Same as JSON, but select **Excel (XLSX)** format.

## JSON file structure

```json theme={null}
{
  "title": "Quiz name",
  "description": "Quiz description",
  "language": "en",
  "questions": [
    {
      "type": "single",
      "content": "Question text?",
      "time_limit": 20,
      "points": 1000,
      "answers": [
        {"content": "Answer A", "is_correct": false},
        {"content": "Answer B", "is_correct": true},
        {"content": "Answer C", "is_correct": false}
      ],
      "explanation": "Explanation (optional)"
    }
  ]
}
```

## Use cases

### Quiz backup

Regularly export important quizzes to JSON as backup.

### Sharing with others

Export quiz and send file to colleague - they can import to their account.

### Moving between accounts

Export from one account → Import to another.

### Creating variants

1. Export quiz
2. Edit JSON file
3. Change title and questions
4. Import as new quiz

## Troubleshooting

<AccordionGroup>
  <Accordion title="Import doesn't work">
    * Check file format (JSON/XLSX)
    * Make sure structure is correct
    * Check character encoding (UTF-8)
  </Accordion>

  <Accordion title="Some questions are missing">
    * Questions with wrong structure are skipped
    * Check if all required fields are filled
  </Accordion>

  <Accordion title="Special characters are corrupted">
    * File must be saved in UTF-8 encoding
    * In Excel: Save as → Choose UTF-8
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Cloning quizzes" icon="copy" href="/en/quizzes/cloning">
    Quick duplication
  </Card>

  <Card title="AI generator" icon="robot" href="/en/ai/generator">
    Automatic quiz creation
  </Card>
</CardGroup>