> 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/~/changes/175/build-and-publish/building-a-quiz.md).
# Building a quiz
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, or with the Quiz Kit AI tool.
The Quiz Kit AI tool quickly generates questions and answers that match your brand, or you can set up custom questions and answers. The AI tool is the quickest method to associate products from your store with quiz questions using intelligent logic.
## In this section:
* [Getting started](#getting-started)
* [Choosing a quiz template](#choosing-a-quiz-template)
* [Option 1: Create a quiz with Quiz Kit's AI tool](#option-1-create-a-quiz-with-quiz-kits-ai-tool)
* [Option 2: Create a quiz from a blank template](#option-2-create-a-quiz-from-a-blank-template)
***
## Getting started
**Steps:**
1. From the Apps menu, click **Quiz Kit: Smart Product Finder** to open the app.
2. From the Quiz Kit dashboard, click **Create a new quiz**. To start your quiz, you can choose between:
1. Start with AI
2. Start with a blank template
***
## Choosing a quiz template
### Option 1: Create a quiz with Quiz Kit's AI tool
**Step 1: Selecting products**
To build your quiz with the AI tool, first you need to tell Quiz Kit AI which products you want to suggest as recommendations based on the quiz questions. These products will be recommended to your customers after they complete a quiz.
You can choose from an existing **Collection** in your store, **Best Sellers**, or you can select individual **Products**.
{% hint style="info" %}
**Best Sellers**\
\
The Quiz Kit AI can select up to 30 top-selling products based on the analytics from your Shopify admin dashboard.
{% endhint %}
1. **Collection** - Choose specific product collections.
2. **Best Sellers** - Top 30 performing products from your Shopify admin dashboard.
3. **Products** - Select up to 100 individual items.
When you’ve made your selection, click **Save and continue**.
***
#### Step 2: Generating your quiz
The Quiz Kit AI recommends quiz questions and answers based on the products that you selected in Step 1. You can change the language and tone of the quiz by adjusting the **Language** and **Tone** drop-down menus and then clicking **Regenerate**.
{% hint style="info" %}
**Note**: A lock icon appears when you hover over a question. Click it if you want to lock that question block from changes before regenerating the rest of the fields with the **Regenerate** button. You can unlock it by clicking the lock again.
{% endhint %}
You can also manually adjust the AI-generated answers to your preference or click the **+** sign under each question to create custom answers.
When you’re happy with the questions and answers, click **Save and continue**.
Lock any items before regenerating questions and choices
***
#### Step 3: Designing and customizing
You can customize your quiz with different styles using Quiz Kit’s premade design templates.
Click on each of the preset style templates on the right-hand menu to update the heading, body, and button styles. Learn more about [customizing your quiz](https://support.quizkitapp.com/build-and-publish/styling-and-customizing-your-quiz).
{% hint style="info" %}
**Note:** If you're confident with code, then you can add custom CSS and JavaScript to your quiz for a more branded appearance. Learn more about [adding custom CSS and Javascript](https://support.quizkitapp.com/general/customizing-your-quiz/applying-custom-css-and-javascript-to-your-quizzes).
{% endhint %}
When you’re happy with the look and feel of your quiz, click **Save and continue**. The Quiz Kit AI generates your personalized quiz.
***
#### Step 4: Previewing, testing, and publishing your quiz
When you're done building your quiz, previewing it, testing it via a test email, and publishing it are all essential steps before your quiz is live to customers.
On this page, you can review the quiz's questions and logic and test the user experience on different devices.
Click the display toggle to see what the customer experience looks like on mobile vs desktop:
When you’re done, click **Edit and publish**.
{% hint style="info" %}
**Note:** There are multiple options for publishing your quiz to your store. [Learn more about publishing your quiz](/~/changes/175/build-and-publish/publishing-your-quiz.md)[.](/~/changes/175/build-and-publish/publishing-your-quiz.md)
{% endhint %}
***
### Option 2: Create a quiz from a blank template
Starting with a blank template offers the most creative freedom in shaping the theme and messaging of your quiz.
If you choose to start with a blank template, then you're directed to the quiz builder page.
**Steps:**
1. From the quiz builder on the left-hand menu, click **Introduction**. This is the first page your customers encounter during the quiz.
2. Click on each sub-section (**Heading**, **Subheading**, **Image**, and **Button**) to familiarize yourself and edit each section. The available editing options appear on the right-hand menu for each sub-section.
3. Click **Add page**, then choose **Question**. In this section, you have the sub-sections:
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**.
4. Optional: You can add additional questions by following repeating step 3. You can also choose to add [additional pages ](/~/changes/175/navigating-the-interface/quiz-builder/quiz/additional-page-types.md)such as **Transition page**, **Form field**, or **Email capture**.
5. When you're done, click **Save** to save your changes.
{% hint style="info" %}
Don't forget to check out the [Recommendations Logic](/~/changes/175/build-and-publish/setting-up-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](/~/changes/175/navigating-the-interface/quiz-builder/results.md)
* [Publish](/~/changes/175/build-and-publish/publishing-your-quiz.md)
* [Style](/~/changes/175/navigating-the-interface/quiz-builder/styles.md)
* [Additional Settings](/~/changes/175/navigating-the-interface/quiz-builder/settings.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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://support.quizkitapp.com/~/changes/175/build-and-publish/building-a-quiz.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.
