> 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/getting-started/first-time-user-guide.md). # First-time user 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. When creating your quiz, you can use AI to quickly generate 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. {% hint style="info" %} **Note:** By default, your first quiz is generated by the Quiz Kit AI. {% endhint %} ## In this section: * [Before you begin](#before-you-begin) * [Choosing a plan](#choosing-a-plan) * [Step 1: Selecting products](#step-1-selecting-products) * [Step 2: Generating your quiz](#step-2-generating-your-quiz) * [Step 3: Designing and customizing](#step-3-designing-and-customizing) * [Step 4: Previewing and testing](#step-4-previewing-and-testing) * [Step 5: Publishing your quiz](#step-5-publishing-your-quiz) *** ## Before you begin {% hint style="success" %} To get started building your first quiz, [install the Quiz Kit app](https://support.quizkitapp.com/quick-start/installation) if you haven’t already. {% endhint %} ### Pricing and plans Quiz Kit includes a **Free 7-day trial** period. After your trial, by default, new Quiz Kit users start on the Scale plan. [The Scale plan](/~/changes/175/account-management/pricing-and-plans.md#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](/~/changes/175/account-management/pricing-and-plans.md). *** ## Step 1: Selecting products {% hint style="info" %} **Note:** This tutorial is based on starting your quiz with Quiz Kit's AI quiz builder. {% endhint %} To set up your quiz, 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 shoppers 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](/~/changes/175/build-and-publish/styling-and-customizing-your-quiz.md). {% 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**.

Choose a style template and use the Save and continue button

*** ## Step 4: Previewing and testing The Quiz Kit AI generates your personalized quiz. 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:

Use the Mobile and Desktop options to view the quiz in different formats

When you’re done, click **Edit and publish**. *** ## Step 5: Publishing your quiz From the Quiz customization page, you can review your quiz again, make further customizations, and when you’re ready, publish it. 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. Learn more about the different options for [publishing your quiz](https://support.quizkitapp.com/general/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 `support@quizkitapp.com`. {% endhint %} *** ### Looking to get more hands on?[ Build a quiz from scratch!](/~/changes/175/build-and-publish/building-a-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 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/getting-started/first-time-user-guide.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.