# Onboarding guide

With Quiz Kit, you can create quizzes that offer customers personalized product recommendations. Use this guide to understand the basics of setting up and publishing your first quiz.\
\
By default, Quiz Kit shows **pre-built templates** as the easiest way to start your first quiz. Templates provide example questions, answers, and designs that you can fully customize to match your brand.

You can also start a quiz from a blank template for full creative control, or use the AI tool to generate questions and answers based on your selected products. Regardless of how you start, all options take you into the same quiz builder to edit questions, results logic, and design.

## In this section:

* [Installation](https://support.quizkitapp.com/getting-started/installation)
* [Free trial](#free-trial)
* [Pricing and plans](#pricing-and-plans)
* [Step 1: Select a template](#step-1-select-a-template)
* [Step 2: Set up questions and answers](#step-2-set-up-questions-and-answers)
* [Step 3: Setting up quiz results](#step-3-setting-up-quiz-results)
* [Step 4: Styling and customizing](#step-4-styling-and-customizing-your-quiz)
* [Step 5: Previewing and testing](#step-4-previewing-and-testing)
* [Step 6: Publishing your quiz](#step-5-publishing-your-quiz)
* [Next steps (Optional)](#next-steps-optional)

***

## Installation

To get started building your first quiz, [install the Quiz Kit app](https://support.quizkitapp.com/getting-started/installation) if you haven’t already.

***

## Free trial

Quiz Kit includes a 10-day free trial so you can explore the app and make sure it fits your business needs. During this period:

* Engagements with your quizzes and the AI Shopping Assistant are tracked.
* Your usage helps determine the [plan tier](https://support.quizkitapp.com/pricing-and-plans#the-scale-plan-1) that offers you the best value (higher tiers = lower cost per engagement).
* When the trial ends, your engagement count resets to zero.
* Your first bill reflects the tier that matches your trial activity so you start on the right-sized plan.

***

## Pricing and plans

[The Scale plan](https://support.quizkitapp.com/pricing-and-plans#the-scale-plan) offers all of the Quiz Kit features, with tiered pricing that's based on the number of engagements that customers have with your quiz or quizzes.

Your store is automatically bumped up to the next tier when you hit the upper threshold of engagements for the tier that you're on. [Learn more about pricing and plans.](https://support.quizkitapp.com/getting-started/pricing-and-plans)

***

## Step 1: Select a template

{% hint style="info" %}
**Note:** This tutorial is based on starting your quiz with Quiz Kit's pre-built templates.
{% endhint %}

**Steps:**

1. After you install Quiz Kit, click **Create a quiz**.
2. You’ll see the available pre-built templates. Click **Use template** on the one you want to start with. All templates lead to the same quiz builder.
3. Or, if you prefer, choose **Create a blank quiz** and skip to [setting up questions and answers](#step-2-set-up-questions-and-answers).

***

## Step 2: Set up questions and answers

After choosing a template (or starting with a blank quiz), you’ll enter the quiz builder. 

Here’s how to structure your quiz content:

* **Introduction page:** Edit the heading, subheading, image, and button that your customers see first.
* **Questions:** Add new questions using the **Add page > Question** option. For each question, you can configure:
  * Question settings
  * Question content
  * Answer options (add extra answers as needed)
* **Additional pages:** Add Transition pages, Form fields, or Email capture sections if desired.
* **Editing interface:** Click a section in the quiz preview to open the side panel and edit its content.

All changes are saved with the **Save** button. 

Once you’ve added your questions and pages, continue to the **Results**, **Style**, and **Settings** sections to finalize your quiz.

Learn more about [drafting questions and pages.](https://support.quizkitapp.com/building-a-quiz/creating-a-quiz/draft-questions-and-pages)

***

## Step 3: Setting up quiz results

The results section is more advanced. Here, you can do the following:

* Choose a results logic type or use AI-generated results
* Review and refine results pages
* Optionally **Enable logic jumps** to customize paths

Because this can get complex, we recommend checking the dedicated guides:

* [Setting up results logic](https://support.quizkitapp.com/building-a-quiz/results/results-logic)
* [Using AI for results](https://support.quizkitapp.com/building-a-quiz/results/ai-fallback-results)
* [Customizing results pages](https://support.quizkitapp.com/building-a-quiz/results/results-template)
* [Creating logic jumps](https://support.quizkitapp.com/building-a-quiz/results/results-logic/creating-logic-jumps)

***

## Step 4: Styling and customizing your quiz

You can quickly style your quiz using the preset theme you chose, or dive deeper with more detailed controls in the quiz builder:

* **Quiz builder styling:** Adjust fonts, buttons, input fields, tooltips, progress bars, and more. Apply styles globally across your quiz or locally to specific pages, questions, or answers for finer control.
* **Advanced settings:** Personalize features like discount codes or quiz behavior.
* **Custom code:** If you have some developer resources, you can add your own CSS or JavaScript for a fully branded experience.

Learn more about [customizing your quiz](https://support.quizkitapp.com/building-a-quiz/styling-and-designing-your-quiz).

{% hint style="success" %}
**Tip:** 

You can click any section in the quiz preview to edit it. The editing panel opens on the right, letting you adjust headings, text, images, buttons, and more without navigating away.

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 %}

***

## Step 5: Previewing and testing

In the quiz builder you can **Preview** what your quiz looks like to customers, and click through it to review questions, logic, and test the user experience. 

Click the display toggle to see what the customer experience looks like on mobile vs desktop:

<figure><img src="https://3560167061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff4VSFR6mflh7oo1yyqTT%2Fuploads%2F4HzIQngEkkTBjNvil2K7%2Frecommended-for-you-screen.jpg?alt=media&#x26;token=3f491947-846b-46f6-bcde-3b6abc6c7809" alt=""><figcaption><p>Use the <strong>Mobile</strong> and <strong>Desktop</strong> options to view the quiz in different formats</p></figcaption></figure>

When you’re done, click **Edit and publish**.

***

## Step 6: Publishing your quiz

From the Quiz customization page, you can review your quiz again, make further customizations, and when you’re ready, publish it. &#x20;

To publish your quiz, click **Publish** at the top of the page, then click the toggle beside **This quiz is currently in draft** to publish it. A quiz page is generated in your Shopify **Pages** section that you can link to.&#x20;

Learn more about the different options for [publishing your quiz](https://support.quizkitapp.com/publish-and-launch/publishing-your-quiz).

{% hint style="info" %}
If you need further help getting Quiz Kit set up, you can contact support using the chat widget in the app or email us at `quizkit@presidiocreative.com`.
{% endhint %}

***

## Next steps (Optional)

If you finish your quiz and are ready for next steps to improve your quizzes performance, you can review the **Next steps** page of the quiz builder.&#x20;

Review the following sections for more information on suggested next steps:<br>

* [AI Shopping Assistant ](https://support.quizkitapp.com/ai-shopping-assistant)
* [Personalization](https://support.quizkitapp.com/advanced-settings/personalizing-your-quiz)