> For the complete documentation index, see [llms.txt](https://support.quizkitapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.quizkitapp.com/building-a-quiz/creating-a-quiz.md).

# Creating a quiz

Learn how to create a quiz, and the difference between the AI template and blank template options.

After you've installed the Quiz Kit app and selected a plan, you can create your first quiz. You can choose between starting with a blank quiz template, an AI pre-built template, or fully building your quiz with an AI.

## In this section:

* [Choosing a quiz start method](#choosing-a-quiz-method)
* [Building a quiz](#build-a-quiz)
  * [Use the quiz builder](#option-1-use-the-quiz-builder)
    * [Start with an AI template](#option-1a-start-with-an-ai-template)
    * [Start from scratch](#option-2a-start-from-scratch)
  * [Build a quiz with AI](#option-2-build-from-an-ai-template)

***

## Choosing a quiz start method

You can start your quiz initially in two ways:

* **Use the quiz builder:** Choose from a template that uses AI to populate your store, or start in the quiz builder from scratch, giving you full control over questions, answers, and design.
* **Build a quiz with AI:** Create your quiz with Claude, ChatGPT, or another AI, then import it into Quiz Kit.

Both methods take you into the quiz builder to edit, style, and publish your quiz. Here, you only choose how to get started.

**Steps:**&#x20;

1. From the Quiz Kit dashboard, click **Create a new quiz**.
2. Choose one of the following:
   1. [Option 1: Use the quiz builder](#option-1-use-the-quiz-builder)
      1. [Start with an AI template](#option-1a-start-with-an-ai-template)
      2. [Start from scratch](#option-2a-start-from-scratch)
   2. [Option 2: Build a quiz with AI](#option-2-build-a-quiz-with-ai)

***

## Building a quiz

### Option 1: Use the quiz builder

#### Option 1a: Start with an AI template

You can use a pre-built AI template as a starting point for your quiz. Templates provide examples of what’s possible within Quiz Kit and help you get started faster. They also use AI to adapt your quiz to your store's products, content, and branding.

After selecting a template, you can customize the questions, answers, results logic, and design settings in the quiz builder.

**Steps:**

1. From the Quiz Kit dashboard, click **Create a new quiz** > **Use the quiz builder**.
2. Optional: Click **View demo** to try a demo of the quiz template of your choice.
3. Click **Use template** under the template you want to use.
4. Under **Describe your quiz**, give AI a brief description of the purpose of your quiz.
5. Click **Build my quiz**.

Once your template has loaded, you can edit the questions and answers as you like, or proceed directly to:

* [Styling and designing your quiz](https://support.quizkitapp.com/building-a-quiz/styling-and-designing-your-quiz.md)
* [Results](https://support.quizkitapp.com/building-a-quiz/results.md)
* [Publishing your quiz](https://support.quizkitapp.com/publish-and-launch/publishing-your-quiz.md)

#### Option 1b: Start from scratch

Starting with a blank template offers the most creative freedom in shaping the theme and messaging of your quiz.&#x20;

If you choose to start with a blank template, then you're directed to the quiz builder page.

**Steps:**

1. From the Quiz Kit dashboard, click **Create a new quiz** > **Use the quiz builder**.
2. Click **Create from scratch**.
3. From the quiz builder, on the left-hand menu, click **Introduction**. This is the first page your customers encounter during the quiz.&#x20;
4. Click on each sub-section (**Heading**, **Subheading**, **Image**, and **Button**) to familiarize yourself and edit each section. You can also click the section in the quiz preview that you want to edit. Editing options appear on the right-hand side for each sub-section.&#x20;
5. Click **Add page**, then choose **Question**. In this section, you have the sub-sections:&#x20;

   1. Question settings
   2. Question **Content**
   3. **Answers**

   Click through each option and its menu settings and adjust as needed. \
   Optional: You can add additional answers by clicking **Add answer**.
6. Optional: You can add additional questions by following repeating step 3. You can also choose to add [additional pages ](https://support.quizkitapp.com/account-and-settings/quiz-builder/quiz/additional-page-types.md)such as **Transition page**, **Form field**, or **Email capture**.
7. When you're done, click **Save** to save your changes.

{% hint style="info" %}
Don't forget to check out the [Recommendations Logic](https://support.quizkitapp.com/building-a-quiz/results/results-logic.md) section.
{% endhint %}

6. After you've completed your quiz, you also need to review and edit the following sections:
   * [Results](https://support.quizkitapp.com/account-and-settings/quiz-builder/results.md)
   * [Style](https://support.quizkitapp.com/account-and-settings/quiz-builder/styles.md)
   * [Additional Settings](https://support.quizkitapp.com/account-and-settings/quiz-builder/settings.md)
   * [Publish](https://support.quizkitapp.com/publish-and-launch/publishing-your-quiz.md)

***

### Option 2: Build a quiz with AI

Create your quiz with Claude, ChatGPT, or another AI tool, then import it into Quiz Kit. Use our built-in prompt to guide the AI through creating your quiz, including its intro, questions, answers, and styling. You can then edit your imported quiz in the Quiz Kit builder before publishing.

**Steps:**

1. From the Quiz Kit dashboard, click **Create a new quiz** > **Build a quiz with AI**.
2. Under **Copy the Quiz Kit prompt**, click **Copy prompt.**
3. Go to your preferred AI tool and paste the prompt.
4. The AI asks questions about your desired quiz. Answer with as much information as you can. Make sure you finalize at the end and download the `.json` file.
5. Go back to Quiz Kit, and under **Import to Quiz Kit** paste or upload the `.json` file.
6. Click **Build my quiz**.

Once your AI quiz has been built, you can edit the questions and answers as you like, or proceed directly to:

* [Styling and designing your quiz](https://support.quizkitapp.com/building-a-quiz/styling-and-designing-your-quiz.md)
* [Results](https://support.quizkitapp.com/building-a-quiz/results.md)
* [Publishing your quiz](https://support.quizkitapp.com/publish-and-launch/publishing-your-quiz.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://support.quizkitapp.com/building-a-quiz/creating-a-quiz.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
