# Quiz Kit Help Center

Quiz Kit helps Shopify merchants create product recommendation quizzes to guide customers to the right products, collect zero-party data, and track quiz performance.

In this help center, you’ll find step-by-step guides, feature explanations, and best practices for building and optimizing your quizzes. You can set up recommendations using flexible logic options, with AI-generated fallback results to simplify setup.

### Start with these helpful resources

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><a href="/pages/TaZnfTmb0iQjK4WkQQK7">Quick Start Guide</a></td><td>Install, launch, and embed your first quiz.</td></tr><tr><td><a href="/pages/MqimmtJU1STuh6Vhl82H">Select a Pricing Plan</a></td><td>Choose the right pricing plan for your store.</td></tr></tbody></table>

### Get support <a href="#need-help-fast" id="need-help-fast"></a>

You can email us at `quizkit@presidiocreative.com` to get help!


# Why Quiz Kit?

A quick introduction to everything Quiz Kit.

Quiz Kit helps Shopify merchants recommend the right products to customers, collect zero-party data, and track how quizzes impact sales, all without coding. You can create a quiz using templates or start from scratch, customize its design, embed it anywhere on your storefront, and see which products perform best.

With Quiz Kit, you can:

* Build quizzes quickly using pre-built templates or a blank quiz
* Recommend products using the different logic types, with optional AI-generated fallback results
* Use personalization to improve the customer experience and make your quiz feel tailored to the individual
* Collect customer data to understand preferences and improve offerings
* Customize the quiz design to work seamlessly on any device

### Popular product quiz use cases

| Use Case                  | Example                                                 |
| ------------------------- | ------------------------------------------------------- |
| **Product-fit quiz**      | “Find your perfect skincare routine”                    |
| **Gift finder**           | Holiday, Mother’s Day, corporate gifts                  |
| **Subscription selector** | Coffee roast & cadence, vitamin plan, pet-food autoship |
| **Bundle builder**        | “Build your own set” kits with fixed quantities         |

***

### Benefits of personalized product quizzes

| Benefit                          | Impact                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------ |
| **Increase conversion & AOV**    | Relevant recommendations encourage larger orders and add-to-cart activity            |
| **Capture zero-party data**      | Collect customer preferences via email/SMS opt-ins and tags for segmentation         |
| **Reduce returns**               | Questions about fit or compatibility upfront help prevent “not right for me” refunds |
| **Maintain customer engagement** | Quizzes keep shoppers on-site and help build trust with your brand                   |

***

### Getting started with Quiz Kit

Quiz Kit integrates directly with Shopify to help you create quizzes that guide shoppers to the right products. Key capabilities include:

* **Flexible setup:** Use pre-built templates or a blank quiz with optional AI-generated fallback results.
* **Logic options:** Points, conditional branches, and AI fallback results to map recommendations.
* **Styling & branding:** Customize fonts, colors, images, and optionally add custom CSS/JS.
* **Add-to-cart & discounts:** One-click add-to-cart or gated coupon codes.
* **Analytics:** Track quiz engagement, revenue, AOV, and lead capture metrics.
* **Integrations:** Connect to Klaviyo, Mailchimp, GA4, Meta Pixel, Recharge, and more.

For step-by-step guidance, follow the **Quick Start Guide** to build and launch your first quiz.

<a href="/pages/TaZnfTmb0iQjK4WkQQK7" class="button primary">Open the Quick Start Guide</a>

***

Need help? Contact support via the in-app chat or email <quizkit@presidiocreative.com>.

Need help? Contact support via the in-app chat or email <quizkit@presidiocreative.com>.


# Past releases

Historical updates to the Quiz Kit app.

{% embed url="<https://mailchi.mp/d643f4f9203d/shiny-new-quiz-kit-ai-builder-and-more>" %}

<table data-card-size="large" data-view="cards" data-full-width="true"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>V7.2024- July 2024</strong></td><td></td><td>NEW product cards, analytics tracking model</td><td><a href="/files/qsjT6YXo1Au1ntHkfTJo">/files/qsjT6YXo1Au1ntHkfTJo</a></td><td></td></tr><tr><td><strong>V6.2024 - June 2024</strong></td><td><p></p><p>Easier results layout and AI improvements</p></td><td></td><td><a href="/files/UmKbUQSWGRu6ZostghsR">/files/UmKbUQSWGRu6ZostghsR</a></td><td><a href="/pages/jZ9AZ65XHHHph0PrLurB">/pages/jZ9AZ65XHHHph0PrLurB</a></td></tr><tr><td><strong>V2.2024 - February 5, 2024</strong></td><td></td><td>Introducing AI quiz results!</td><td><a href="/files/Up7yQjYQzJPXezAquR41">/files/Up7yQjYQzJPXezAquR41</a></td><td><a href="/pages/Or2MDxXfcvXYCV4f4rXX#v2.2024-february-5-2024">/pages/Or2MDxXfcvXYCV4f4rXX#v2.2024-february-5-2024</a></td></tr><tr><td><strong>V12.2023 - Dec 5, 2023</strong></td><td></td><td>A new and improved streamlined Quiz Editor. </td><td><a href="/files/cp9eqkDMdVwJIYdHnjps">/files/cp9eqkDMdVwJIYdHnjps</a></td><td></td></tr><tr><td><strong>V10.2023- Oct 10, 2023</strong></td><td></td><td>Homepage revisions and updates. New templates, improved analytics summary.</td><td><a href="/files/wHxbOPTOtO8r7SHZ9hLZ">/files/wHxbOPTOtO8r7SHZ9hLZ</a></td><td></td></tr></tbody></table>


# Release notes

## V9.2024 - September 2024

Custom results pages, centralized styling, and unique results URL

### **Added**

* A unique URL for quiz results that can be seamlessly passed to any CRMs
* An option for customers to subscribe separately after completing a quiz
* [Custom content settings ](https://support.quizkitapp.com/navigating-the-interface/quiz-builder/results/new-custom-content)

### Fixes and other improvements

* The default analytics range is now expanded up to the past 30 days

## V7.2024 - July 2024

### **Added**

**New product card**&#x20;

* Improves product visibility and simplifies navigation by showcasing variants directly on the main image.

**Fixes and other improvements**

[<mark style="color:green;">**New revenue tracking model**</mark>](https://support.quizkitapp.com/general/data-and-analytics)

* Track all items added to the cart within 7 days of completing the quiz, as long as they are added in the same browser. This new model allows us to better monitor and attribute sales generated from the Quiz.

## V6.2024 - June 2024

Easier results layout and AI improvements

### **Added**

* Results layout decoupled
* AI-driven question creation

{% embed url="<https://www.youtube.com/watch?index=4&list=PLZ4PRU8_z6oksgbZanqHqrrqrD3AtsGGa&v=tRXx3rsyTt4>" %}

* New integrations with [Yotpo](/building-a-quiz/integrations/marketing-automation/yotpo) and [Pagefly](/building-a-quiz/integrations/marketing-automation/pagefly)

### Fixes and other improvements

* Improved templates UI

***

## V5.2024 - May 30 2024

### **Added**&#x20;

* The manual result builder is simplified
* Control progress bar visibility for a personalized experience
* Ability to disable questions and answers as customer tags &#x20;

### Fixes and other improvements

* Consolidated button style settings.
* Accessibility improvements&#x20;
  * Focus indicators for actionable elements now meet high standard contrast requirements
  * buttons are marked up as such so they are usable by keyboard users
  * Image links are properly labeled for screen reader users and so much more!
* Better SEO optimization by optionally excluding H1 headings on quizzes

***

## V3.2024 - March 6 2024

AI auto results enhancements

### **Added**

* AI text generation
* Increased AI product recommendation capacity from 20 to 100.&#x20;

### Fixes and other improvements

* Improved image loading and transitions
* Recommend by tags with AND/OR logic

##

***

## V2.2024 - February 5 2024

AI Auto Results launch 🎉

### **Added**

* [<mark style="color:purple;">New</mark> ](/building-a-quiz/results/fallback-results)<mark style="color:purple;">AI Auto results</mark>
* Share your popup quiz via URL link

### Fixes and other improvements

* Quick view fonts (Alphabetical order)


# V9.2024 - September

## V9.2024 - September 2024

Custom results pages, centralized styling, and unique results URL

### **Added**

* A unique URL for quiz results that can be seamlessly passed to any CRMs
* An option for customers to subscribe separately after completing a quiz
* [Custom content settings ](https://support.quizkitapp.com/navigating-the-interface/quiz-builder/results/new-custom-content)

### Fixes and other improvements

* The default analytics range is now expanded up to the past 30 days


# V7.2024 - July 2024

New and improved product cards and analytics page

### **Added**

**New product card**&#x20;

Improves product visibility and simplifies navigation by showcasing variants directly on the main image.

* Variants can be displayed on top of the main product image
* There is a duplicate of the Add to Cart button in case of many variants
* Ability to adjust the font styles for each product card component separately
* You can display additional product images as a slideshow on hover
* There are more aspect ratio options available
* New setting for the corner rounding of the product image and the “Add to Cart” button&#x20;
* Add to Cart buttons are now seamlessly aligned on the result pages

<figure><img src="/files/qsjT6YXo1Au1ntHkfTJo" alt=""><figcaption></figcaption></figure>

### Fixes and other improvements

[<mark style="color:green;">**New revenue tracking model**</mark>](https://support.quizkitapp.com/general/data-and-analytics)

* Track all items added to the cart within 7 days of completing the quiz, as long as they are added in the same browser. This new model allows us to better monitor and attribute sales generated from the Quiz.


# V6.2024 - June 2024

Easier results layout and AI improvements

### **Added**

* Results layout decoupled
* AI-driven question creation

{% embed url="<https://www.youtube.com/watch?index=4&list=PLZ4PRU8_z6oksgbZanqHqrrqrD3AtsGGa&v=tRXx3rsyTt4>" %}

* New integrations with [Yotpo](/building-a-quiz/integrations/marketing-automation/yotpo) and [Pagefly](/building-a-quiz/integrations/marketing-automation/pagefly)

### Fixes and other improvements

* Improved templates UI


# V5.2024 - May 2024

### **Added**&#x20;

* The manual result builder is simplified
* Control progress bar visibility for a personalized experience
* Ability to disable questions and answers as customer tags &#x20;

### Fixes and other improvements

* Consolidated button style settings.
* Accessibility improvements&#x20;
  * Focus indicators for actionable elements now meet high standard contrast requirements
  * buttons are marked up as such so they are usable by keyboard users
  * Image links are properly labeled for screen reader users and so much more!
* Better SEO optimization by optionally excluding H1 headings on quizzes


# What is AI Shopping Assistant?

Learn how AI Shopping Assistant helps customers on your store by answering questions and recommending products.

AI Shopping Assistant is an AI-powered assistant that helps customers in your store by answering questions, recommending products, and guiding purchase decisions. It works by syncing with your store data so it can understand product details and then respond to shoppers in real time through a chat window or embedded page blocks.

You can use AI Shopping Assistant to:

* Help shoppers compare similar products and make confident choices
* Provide personalized product recommendations based on quiz answers or attributes
* Collect email sign-ups directly in the chat flow
* Offer multilingual support to reach international customers

AI Shopping Assistant includes a floating chat button, optional page blocks, and styling controls so you can customize how it looks and behaves on your store. You can also define product rules, set the chat tone, and choose the languages it supports.


# Quick start guide

Learn the basics on how to get started with AI Shopping Assistant chatbot.

AI Shopping Assistant is a customizable, AI-powered chatbot that exists on your storefront and helps customers discover products by answering their questions. AI Shopping Assistant learns from your store data so it can answer customer questions and recommend products in real time.

This guide walks you through setting up the app, training it with your store data, customizing the appearance and tone, and making it live on your store.

## In this section

1. [Sync your store data](#id-1.-sync-your-store-data)
2. [Select a theme to apply AI Shopping Assistant to](#id-2.-select-a-theme-to-apply-ai-shopping-assistant-to)
3. [Customize the AI Shopping Assistant](#id-3.-customize-the-ai-shopping-assistant)
4. [Add the page chat section](#id-4.-add-the-page-chat-section)
5. [Add product page prompts](#id-5.-add-product-page-prompts)
6. [Review or update chat styling](#id-6.-review-or-update-chat-styling)
7. [Set product rules](#id-7.-set-product-rules)
8. [Enable email sign-up](#id-8.-enable-email-sign-up)
9. [Add a customer support tab](#id-9.-add-a-customer-support-tab)
10. [Apply language settings](#id-9.-apply-language-settings)

***

### 1. Sync your store data

You need to let AI Shopping Assistant sync your store to learn about your products, metafields, and pages so that it can make intelligent product recommendations to your customers.

After you've installed the Quiz Kit app, find AI Shopping Assistant in the menu bar, do the following:

**Steps:**

1. Click **Start setup**.
2. If you have a password on your storefront, then enter it in the **Your password** field, and press enter.
3. Click **Sync data** to allow AI Shopping Assistant to collect information from your products, collections, pages, and metafields.

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

Syncing might take a minute. You can continue setup while syncing runs in the background.
{% endhint %}

Syncs happen automatically every 3 days. You can re-sync manually anytime after making store updates.

[Learn more about syncing your store data](/ai-shopping-assistant/setting-up-ai-assistant/syncing-and-training).

***

### 2. Select a theme to apply AI Shopping Assistant to

Add AI Shopping Assistant to your storefront by connecting it to a theme.

* In the **Select Theme** step, from the drop-down menu, choose one of your existing store themes to apply AI Shopping Assistant to.&#x20;
* This step connects the AI Shopping Assistant to your theme via Shopify’s theme editor.
* Click **Enable app embed** to launch the theme editor settings.

[Learn more about adding AI Shopping Assistant to your theme](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling#apply-ai-shopping-assistant-to-your-theme).

***

### 3. Customize the AI Shopping Assistant

In the theme editor, you can:

* Toggle the chat bubble on/off, adjust its position, color, corners, and hover text.
* Customize the chat window, including header, welcome text, conversation bubbles, and AI avatar.
* Style AI suggested questions and product prompts, including colors, corners, and scrolling marquee.
* Add custom CSS for advanced styling.

Make any customizations you want, then click **Save** to apply your changes.

[Learn more about customizing and styling AI Shopping Assistant](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling#what-you-can-customize).

***

### 4. Add the page chat section

You can add a full-width chat section, ideal for collection or landing pages.&#x20;

**Steps:**

1. From the AI Shopping Assistant dashboard under **Page chat**, click **Enable section**. Your theme editor is launched and the Page chat is added. Click **Got it**.
2. Optional: Drag the section block up or down to move it to the position you want.
3. Click the page chat block on the page to open customization options for the section such as logo, header and subheading text.
4. Click **Save.**

[Learn more about adding the page chat section](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling#add-the-page-chat-block).

***

### 5. Add product page prompts

Next you can add the question prompts to your product pages. This can be static questions prompts or a banner that scrolls on the product page.

**Steps:**

1. From the **AI Shopping Assistant** dashboard, under **Product page prompts**, click **Edit placement**. Your theme editor will open on a product page.
2. (Optional) Drag the section block up or down to place it where you want on the page.
3. Click **Save** to apply your changes.

[Learn more about adding product page prompts](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling#add-product-page-prompts).

***

### 6. Review or update chat styling

You can return to the theme editor at any time to review or adjust your AI Shopping Assistant’s appearance. This includes colors, fonts, chat bubble shape, and header logo.

**Steps:**

1. From the AI Shopping Assistant dashboard, under **Style conversation**, click **Customize** to open the theme editor.
2. Make any adjustments you want (or leave settings as they are).
3. Click **Save**.

***

### 7. Set product rules

You can limit which products AI Shopping Assistant can recommend.

* You can set the maximum number of products that AI Shopping Assistant can suggest in a single response
* In the **Excluded Products** section, select any products you don’t want included in recommendations.
  * You can also exclude out of stock products.

[Learn more about product rules](/ai-shopping-assistant/setting-up-ai-assistant/ai-shopping-assistant-behavior#product-rules).

***

### 8. Enable email sign-up

AI Shopping Assistant can collect customer emails during chat to help grow your mailing list. You can also add a discount code or GDPR checkbox if needed.

**Steps:**

1. From the **AI Shopping Assistant** dashboard, go to **Email sign-up**.
2. Expand the settings and configure your prompts, optional discount, and GDPR options.
3. Click **Save & activate**.

[Learn more about enabling email sign up](/ai-shopping-assistant/setting-up-ai-assistant/ai-shopping-assistant-behavior#email-sign-up).

***

### 9. Add a customer support tab

You can choose to enable a customer support tab at the top of your AI chat window. From the Launch customer support chat section, add the header labels that show on the chat, and decide how you want the chat to open.

[Learn more about the customer support tab](/ai-shopping-assistant/setting-up-ai-assistant/ai-shopping-assistant-behavior#launch-customer-support).

***

### 10. Apply language settings

Choose the language for your AI Shopping Assistant to communicate in from the drop-down menu, then click **Save**.

[Learn more about language settings](/ai-shopping-assistant/setting-up-ai-assistant/ai-shopping-assistant-behavior#language-settings).

***


# Setting up AI Assistant

Learn how to set up the AI Shopping Assistant for the first time in your store.

Learn how to set up and customize AI Shopping Assistant for your storefront. Start by syncing your store so the AI can understand your products, then add it to your theme. From there, you can adjust the chat overlay, style the conversation, and define how the AI interacts with customers.

## In this section

* [Syncing your store and training the AI Shopping Assistant](/ai-shopping-assistant/setting-up-ai-assistant/syncing-and-training)
  * [Initial store sync](#initial-store-sync)
  * [Additional syncing](/ai-shopping-assistant/setting-up-ai-assistant/syncing-and-training#additional-syncing)
* [Customizing and styling](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling)
  * [Apply AI Shopping Assistant to your theme](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling#apply-ai-agent-to-your-theme)
  * [Customize the floating chat button](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling#customize-the-floating-chat-button)
  * [Add the page chat section](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling#add-the-page-chat-section)
  * [Add the product page block](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling#add-the-product-page-block)
  * [Styling the chatbot](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling#styling-the-chatbot)
* [AI Shopping Assistant behavior](/ai-shopping-assistant/setting-up-ai-assistant/ai-shopping-assistant-behavior)
  * [Product rules](/ai-shopping-assistant/setting-up-ai-assistant/ai-shopping-assistant-behavior#product-rules)
  * [Email sign up](/ai-shopping-assistant/setting-up-ai-assistant/ai-shopping-assistant-behavior#email-sign-up)
  * [Launch customer support](/ai-shopping-assistant/setting-up-ai-assistant/ai-shopping-assistant-behavior#launch-customer-support)
  * [Language settings](/ai-shopping-assistant/setting-up-ai-assistant/ai-shopping-assistant-behavior#language-settings)


# Syncing and training

Learn how to sync your store and train AI Shopping Assistant so it can recommend products and answer customer questions accurately.

AI Shopping Assistant needs access to your store’s products, pages, and content to provide helpful recommendations and respond to customer questions. Syncing your store trains the AI model and ensures it stays up to date with any changes.&#x20;

You can perform an initial sync, and additional syncs happen automatically every three days or you can sync manually, whenever you like. This helps your customers get the most accurate and timely guidance while shopping.

***

## Initial store sync

You need to let AI Shopping Assistant sync your store to learn about your products, metafields, and pages so that it can make intelligent product recommendations to your customers.

After you've installed the Quiz Kit app, navigate to the AI Shopping Assistant in the menu bar, and then do the following:

**Steps:**

1. Click **Start setup**.
2. If your storefront is password-protected, enter your password and press enter.
3. Click **Sync data** to allow AI Shopping Assistant to collect information from your products, collections, pages, and metafields.

Syncing might take a minute. You can [continue setting up AI Shopping Assistant](/ai-shopping-assistant/setting-up-ai-assistant/customizing-and-styling) while syncing runs in the background.

***

## Additional syncing

Syncs happen automatically every 3 days.&#x20;

You can re-sync your store any time later by clicking **Sync store** under **Sync data** on the dashboard. This updates the AI Shopping Assistant with any new changes in your store and ensures customers get the most accurate information.


# Customizing and styling

Learn how to customize AI Shopping Assistant’s chat button, page sections, and product banners to match your store’s design.

After you [initiate your first AI Shopping Assistant sync](/ai-shopping-assistant/setting-up-ai-assistant/syncing-and-training#initial-store-sync), you can customize its appearance and placement to fit your theme. You can apply it to a theme, adjust the floating chat button, add chat sections to pages, include suggested questions on product pages, and style the chat window.&#x20;

These settings help ensure the AI experience feels integrated with your storefront and matches your brand’s look and feel.

## In this section

* [Apply AI Shopping Assistant to your theme](#apply-ai-shopping-assistant-to-your-theme)
  * [Customize the AI Shopping Assistant](#customize-the-ai-shopping-assistant)
* [Add the page chat block](#add-the-page-chat-block)
* [Add product page prompts](#add-product-page-prompts)
* [Review or update chat styling](#review-or-update-chat-styling)

***

## Apply AI Shopping Assistant to your theme

AI Shopping Assistant functions as an app in your theme, so you need to choose a theme to add it to before you can start customizing and styling its appearance.

**Steps:**

1. From the AI Shopping Assistant dashboard, under the **Select Theme** drop-down menu, choose one of your existing store themes to apply AI Shopping Assistant to.&#x20;
2. Click **Enable app embed** to launch the theme editor.
3. [Customize](#what-you-can-customize) the AI Shopping Assistant, then click **Save**.&#x20;

#### What you can customize:

You can customize the following:

* **Chat bubble:** The floating button that appears on every page (when enabled). Customers click it to open the AI Shopping Assistant chat window.
* **Chat window:** The interface where customers interact with the AI Shopping Assistant and receive personalized product recommendations.
* **Conversation:** The back-and-forth exchange between the AI Assistant and the customer within the chat window.
* **AI-suggested questions and product prompts:** The automatically generated prompts and product suggestions shown in the chat window—and, if added, on the product page via the [embedded theme block](#add-product-page-prompts).

<table><thead><tr><th width="203.1484375">Section</th><th>What you can do</th></tr></thead><tbody><tr><td><strong>Chat bubble</strong></td><td><ul><li>Turn on/off</li><li>Change position (left/right, vertical)</li><li>Set hover text and color</li><li>Adjust icon, background, and border colors</li><li>Choose corner style (square, rounded, pill)</li></ul></td></tr><tr><td><strong>Chat window and conversation</strong></td><td><ul><li>Customize background and header colors</li><li>Upload header icon</li><li>Set welcome heading and intro text</li><li>Style conversation bubbles (customer &#x26; AI colors, corners)</li><li>Upload AI avatar</li></ul></td></tr><tr><td><strong>AI suggested questions &#x26; product prompts</strong></td><td><ul><li>Enable product page marquee</li><li>Customize icon, text, and container colors</li><li>Adjust question container corners</li></ul></td></tr><tr><td><strong>Advanced customization</strong></td><td><ul><li>Add custom CSS for advanced styling</li></ul></td></tr></tbody></table>

***

## Add the page chat block

You can add a full-width chat section, ideal for collection or landing pages.&#x20;

**Steps:**

1. From the AI Shopping Assistant dashboard, under **Page chat**, click **Edit placement**. Your theme editor is launched and the Page chat is added. Click **Got it**.
2. Optional: Drag the section block up or down to move it to the position you want.
3. Click the page chat block on the page preview to open customization options for the section such as logo, and heading and subheading text.
4. Click **Save.**

***

## Add product page prompts

Next, you can add the question prompts to your product pages. This can be static question prompts or a banner that scrolls on the product page.

**Steps:**

1. From the AI Shopping Assistant dashboard, under **Product page prompts**, click **Edit placement**. Your theme editor is launched and the Product page prompts block is added. Click **Close**.
2. Optional: Drag the section block up or down to move it to the position you want
3. Click **Save**.

***

## Review or update chat styling

You can return to the theme editor at any time to review or adjust your AI Shopping Assistant’s appearance. This includes colors, fonts, chat bubble shape, and header logo.

**Steps:**

1. From the AI Shopping Assistant dashboard, under **Style conversation**, click **Customize** to open the theme editor.
2. Make any adjustments you want (or leave settings as they are).
3. Click **Save**.


# AI Shopping Assistant behavior

Learn how to control AI Shopping Assistant’s product recommendations, chat style, email sign-ups, and language settings.

AI Shopping Assistant’s behavior can be customized to fit your store and customer experience. You can limit which products it recommends, set the tone of its conversations, collect customer emails during chats, and select the language it uses.&#x20;

These settings help ensure AI Shopping Assistant communicates effectively, highlights the right products, and aligns with your brand voice.

## In this section

* [Product rules](#product-rules)
* [Email sign up](#email-sign-up)
* [Launch customer support](#launch-customer-support)
* [Language settings](#language-settings)

***

## Product rules

Under the **Product rules** section of the AI Shopping Assistant dashboard, you can limit which products AI Shopping Assistant can recommend. In the **Product rules** section, click the drop-down arrow to expand the options in this section.

**Maximum products**

In the **Maximum products** section, you can set the maximum number of products that AI Shopping Assistant can suggest in a single response.&#x20;

Click and drag the slider to increase or decrease the maximum number of products.

**Excluded products**

In the **Excluded Products** section, you can select any products you don’t want included in recommendations.

Click in the **Search products** text box to search for and select which products you want to exclude.&#x20;

You can also check **Exclude out of stock products** if you don't want AI Shopping Assistant to recommend anything out of stock.

***

## Email sign up

AI Shopping Assistant can collect customer email addresses during chat interactions. You can customize the prompt that customers click and the text the AI Shopping Assistant uses in the interaction. You can also choose to include a discount code.&#x20;

{% hint style="info" %}
**Note**

To include a discount code, it needs to be created outside of the AI Shopping Assistant.
{% endhint %}

**Steps:**

1. From the AI Shopping Assistant dashboard, under **Email sign up**, click the down arrow to open the settings.
2. Optional: If you want to include a discount code, check **Include a discount code** and click the drop-down menu, then select it.
3. Under **Customer prompt**, enter the text that you want customers click to start the email sign up process. For example, `Is there a discount?`
4. Under **Email sign up start**, enter the text displayed when the email sign-up form appears. For example, `Join our mailing list and we'll send you 10% off your first purchase!`
5. Optional: If you live in a GDPR region, you can check **Add GDPR checkbox**, which adds a box that customers need to check to proceed.
6. Under **Sign up success message**, enter the text that displays after the customer submits their email.
7. Click **Save & activate.**

Collected emails are saved to **Customers** in your Shopify admin.

***

## Launch customer support

You can add a tab to the top of your chatbot widget that launches your customer support (either a separate chat widget, or a contact page).

**Steps:**

1. From the AI Shopping Assistant dashboard, go to **Launch customer support** and click the drop-down arrow to expand the options in this section.
2. Under Header labels, enter the **AI chat label** and the **Support label** that display at the top of the chat window for both the AI chat and to launch the support window.&#x20;
3. Choose how support opens. You can choose to either:
   1. **Launch a link:** Opens your support link in a new window.
   2. **Launch a support chat (JavaScript):** Uses JavaScript to launch the support chat in the current window.
4. Click **Enable feature**.

The feature is enabled. You can disable it at any time by coming back to these settings.

***

## Language settings

You can change the language that the AI Shopping Assistant communicates in.

**Steps:**

1. From the AI Shopping Assistant dashboard, in the **Language settings** section, click the drop-down arrow to expand the options in this section.
2. From the drop-down menu, choose the language that you want to apply to the AI Shopping Assistant.
3. Click **Save**.


# Training AI responses

Train AI Shopping Assistant to learn from your own questions and responses.

After you've synced your store, you can add custom responses to help train the AI Shopping Assistant chatbot to give accurate, on-brand answers to customer questions.&#x20;

This helps AI Shopping Assistant handle store-specific inquiries that go beyond the information it automatically learns from your synced products and collections. Use custom responses to share details like shipping times, return policies, or special promotions, and even link to relevant products or collections when it’s helpful.&#x20;

Over time, this can make AI Shopping Assistant more reliable, consistent, and aligned with your store’s tone of voice.

***

## Add a custom response

**Steps:**

1. From the AI Shopping Assistant dashboard, click **Train AI**.
2. Click **Add a new response**.
3. In the **Question** text box, enter a customer question such as `How long does shipping take?`
4. &#x20;In the **Response** text box, enter any details that you think will help the solve the customer's query. For example, `Shipping takes 5-7 business days. See our shipping policy for details.`
5. Optional: In the **Destination** **product page** text box, click the search bar, and check which products you want to recommend for this question, if applicable.
6. Click **Save**.


# Analytics and tracking

Learn how to monitor your AI Shopping Assistant’s performance and customer interactions.

Learn about the tools that help you understand how your AI Shopping Assistant is performing in your store. You can review customer interactions, track engagement, and monitor activity over time.

Use these insights to improve product data, refine responses, and better understand customer behavior.

## In this section:

* [AI Shopping Assistant analytics](/ai-shopping-assistant/analytics-and-tracking/ai-shopping-assistant-analytics)
* [Conversation logs](/ai-shopping-assistant/analytics-and-tracking/conversation-logs)


# AI Shopping Assistant analytics

Learn about your AI Shopping Assistant's analytics and conversion and compare data over time.

You can use the Analytics page in AI Shopping Assistant to see how your chat assistant is performing. The Analytics page displays metrics such as revenue, conversion rate, click throughs, and add-to-cart events to understand how recommendations impact your store.&#x20;

You can set a custom timeframe and compare performance to a previous period to track trends over time.&#x20;

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

Metrics are calculated using a 10-day attribution window. This means interactions with recommended products are counted for up to 10 days after they occur.
{% endhint %}

## **In this section**

* [Accessing your AI Shopping Assistant Analytics](#accessing-your-ai-agent-analytics)
* [Understanding your metrics](#understanding-your-metrics)

***

## **Accessing your** AI Shopping Assistant **Analytics**

**Steps:**

1. From the AI Shopping Assistant dashboard, click the **Analytics** tab.
2. Optional: To select a timeframe, click **Today** (calendar icon) and select a timeframe. Your timeframe is automatically compared to the previous, same time frame. (For example, the last 7 days are compared to the 7 days before that.)
3. Click **Apply**.

Your analytics are displayed as compared to the comparison timeframe. You can confirm the comparison timeframe by looking beside the calendar picker button, where it says **Compare**.&#x20;

***

## **Understanding your metrics**

<figure><img src="/files/i3sGQTDsTFUUWTod7hvx" alt="AI Agent Analytics dashboard overview example"><figcaption></figcaption></figure>

**Revenue:**

The total sales amount generated from products recommended by AI Shopping Assistant. Revenue is tracked when a customer completes a purchase within 10 days of engaging with a recommended product in the chat.

**Conversion:**

The percentage of AI Shopping Assistant sessions that result in an order. Conversion is calculated as: **`(sessions with orders ÷ total number of sessions) × 100`**

We track conversions for products that have been recommended, added to the cart, or clicked through within a 10-day attribution window.

**Click through:**

The percentage representing how often customers click a recommended product in the AI Shopping Assistant chat to view its product page. This measures interest but does not guarantee the product was added to the cart or purchased.&#x20;

**Add to cart:**

The total number of times a product is added to a cart after being recommended by AI Shopping Assistant. This includes:

* **In-chat adds:** When a customer clicks the **Add to cart** button directly within the AI Shopping Assistant chat.
* **On-site adds:** When a customer clicks through to a product page from the chat and then adds the product to their cart.

Add to cart events are tracked within a 10-day attribution window.

**Top recommendations**

The most popular recommendations, ordered from most often recommended to least. You can see the number of times that product was recommended in the given timeframe you selected.


# Conversation logs

Learn about how to track and review AI Shopping Assistant chat conversations with customers.

In the **Conversation logs,** you can track and review the AI Shopping Assistant's chat interactions with customers. See exactly what customers are asking, how AI Shopping Assistant responds, and which products or collections are being recommended.&#x20;

You can use this information to identify common questions, improve your product data, and fine-tune AI Shopping Assistant’s responses over time. You can also filter conversations by date and export logs for deeper analysis or reporting.

## In this section

* [View your conversation logs](#view-your-conversation-logs)
* [Export your conversation logs](#export-your-conversation-logs)

***

## View your conversation logs

**Steps:**

1. From the AI Shopping Assistant dashboard, click **Logs**.
2. Click the drop-down calendar button, then select the timeframe that you want to view.
3. Find a conversation you want to review in the list, and click it to expand the section.

## Export your conversation logs

**Steps:**

1. From the AI Shopping Assistant dashboard, click **Logs**.
2. Click the drop-down calendar button, then select the timeframe that you want to export.
3. To the right of **Agent conversations log**, click the down-facing arrow.
4. Click **Export**.

The .xlsx file download with your data is initiated.


# AI Assistant FAQs

Frequently asked questions for the AI Shopping Assistant product recommendation chatbot.

<details>

<summary>What is AI Shopping Assistant?</summary>

AI Shopping Assistant is a chatbot that helps customers find products and collections in your store by answering their questions.&#x20;

It gets to know each customer, learning their preferences, and guiding them through a shopping experience that feels personal every time they use it.

</details>

<details>

<summary>How does AI Shopping Assistant know what to recommend?</summary>

AI Shopping Assistant syncs with your store and collects information about your products, collections, pages, and metafields. It uses this data, along with the context of a customer’s question, to suggest relevant items.

</details>

<details>

<summary>How often does it sync?</summary>

AI Shopping Assistant automatically syncs with your store every 3 days to keep its product recommendations up to date.&#x20;

</details>

<details>

<summary>I changed something on my store, can I manually sync it?</summary>

Yes. You can trigger a manual sync at any time from the AI Shopping Assistant settings panel to immediately update the data used by the chatbot.

</details>

<details>

<summary>How do I exclude certain products from the product recommendations?</summary>

You can exclude products during setup under Excluded products, or update your exclusions at any time. After making changes, make sure to re-sync to apply the updates.

</details>

<details>

<summary>What data does AI Shopping Assistant sync from my store?</summary>

AI Shopping Assistant collects details about your products (like titles, descriptions, tags, variants), collections, pages, and custom metafields to provide accurate answers and recommendations. It doesn't collect data on customer information, orders, or analytics.

</details>

<details>

<summary>Can I see common questions asked to AI Shopping Assistant?</summary>

Yes. You can view past conversations and customer questions in the Logs section.

</details>

<details>

<summary>Can I adjust responses?</summary>

No. You can change the tone of voice that the chatbot uses, but you can’t create your own responses.

</details>

<details>

<summary>How much does AI Shopping Assistant cost?</summary>

AI Shopping Assistant is currently included as a free trial for all paying customers of Quiz Kit. Once our beta of the product launch is finished, we'll provide an update on the pricing plans for the AI Shopping Assistant.

</details>

<details>

<summary>What metrics are being tracked?</summary>

We track the following data and events:

Revenue, conversion, click through, add to cart, and top recommended products

</details>

<details>

<summary>Can the AI Shopping Assistant be used alongside my existing storefront chat app?</summary>

This feature is coming soon and will allow customers to trigger your internal customer support widget on their own.

</details>

<details>

<summary>How do you track conversions?</summary>

Conversions are tracked using the customer event pixel, which is automatically enabled when you install the Quiz Kit app.

</details>

<details>

<summary>Why doesn’t the cart update immediately when customers add a product from the AI Shopping Assistant?</summary>

When you click **+** on a product recommendation, the item is added to your cart, but it may not appear instantly in the cart count or cart preview. Refreshing the page shows the updated cart.&#x20;

You can contact our support team at [`quizkit@presidiocreative.com`](mailto:quizkit@presidiocreative.com) to have this adjusted for your store.

</details>

<br>


# Installation

Learn how to install the Quiz Kit app.

Welcome to Quiz Kit! To get started, follow the instructions below:

1. Go to Quiz Kit's app page in [<mark style="color:purple;">Shopify's app store</mark>](https://apps.shopify.com/quiz-kit) and click **Install.**
2. From the installation page, review the information, then click **Install.**

Upon installation, you have access to our **10-day free trial!**&#x20;

Use this time to set up your quiz, try our AI-generated quiz results, explore our offerings and test out our features.&#x20;

Learn more about [pricing plans](/getting-started/pricing-and-plans), and check out our [First-time user guide](/getting-started/onboarding-guide) to orient yourself to get started!


# Pricing and plans

Learn about Quiz Kit pricing and billing.

New Quiz Kit users start on the Scale plan after their free trial. The Scale plan offers all of the Quiz Kit features, with tiered pricing that's based on the number of engagements customers have with your quizzes, and with the [AI Shopping Assistant](/ai-shopping-assistant/what-is-ai-shopping-assistant).

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.&#x20;

Pricing is based on the number of monthly engagements across your quizzes and AI Shopping Assistant. An engagement is counted each time a customer makes their first click to start the quiz.

### In this section <a href="#in-this-section" id="in-this-section"></a>

* [Free trial](#the-scale-plan)
* [The Scale plan](#the-scale-plan)
  * [Engagements](#engagements)
  * [Scale plan features](#scale-plan-features)
    * [Scale plan tiers](#scale-plan-tiers)
* [Adjusting your plan tier](#adjusting-your-plan-tier)
* [How you're billed](#how-youre-billed)
* [Cancel your Quiz Kit plan](#cancel-your-quiz-kit-plan)
* [Support](#support)

***

## Free trial <a href="#the-scale-plan" id="the-scale-plan"></a>

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

{% hint style="info" %}
**Note**&#x20;

After your first bill, your tier only increases automatically if engagement exceeds the current tier. It doesn't automatically decrease if engagement drops in a lower-traffic month.&#x20;
{% endhint %}

## The Scale plan <a href="#the-scale-plan" id="the-scale-plan"></a>

After your trial ends, you're placed into the Scale plan tier that best fits your trial usage, and your engagement count resets to zero.

From there:

* Your tier only increases automatically when you hit the next engagement threshold. If your monthly engagements fall below your current tier, then your plan doesn't automatically downgrade. You can [contact support](/faqs-and-support/contact-us) to adjust it.
* Example tiers:
  * $59/month for 0–500 engagements
  * $99/month for 501–750 engagements
* Higher tiers give you a lower cost per engagement, so you get better value as engagement increases as long as your engagements land in that bracket.

This ensures you start on the right plan and only upgrade based on your ongoing activity, not your trial count.

### Engagements

An engagement is counted each time a new or returning customer initiates interaction with your quiz or AI Shopping Assistant for the first time (ie. the first click) in a session.

### Scale plan features <a href="#scale-plan-features" id="scale-plan-features"></a>

The Scale plan has all the features that are offered within the Quiz Kit app:

**Robust quiz creation**

* Unlimited quiz creation
* Logic jumps
* AI-generated fallback results
* AI Shopping Assistant
* File upload
* Personalization
* Complete CSS/JS control

**User engagement**

* Post-quiz personalization features
* Email quiz results
* Custom branding

**Advanced tools**

* A/B testing
* End-to-end conversion tracking
* Comprehensive analytics
* Flexible quiz logic
* Seamless tool integrations

### Scale plan tiers <a href="#scale-plan-tiers" id="scale-plan-tiers"></a>

<table><thead><tr><th width="246.78515625">Price</th><th>Number of quiz engagements</th></tr></thead><tbody><tr><td>$59</td><td>Up to 500</td></tr><tr><td>$99</td><td>501 to 850</td></tr><tr><td>$169</td><td>851 to 1,500</td></tr><tr><td>$269</td><td>1,501 to 2,500</td></tr><tr><td>$369</td><td>2,501 to 4,000</td></tr><tr><td>$449</td><td>4,001 to 5,500</td></tr><tr><td>$529</td><td>5,501 to 7,500</td></tr><tr><td>$599</td><td>7,501 to 10,000</td></tr><tr><td>$699</td><td>10,001 to 15,000</td></tr><tr><td>$799</td><td>15,001 to 20,000</td></tr><tr><td>$999</td><td>20,001 to 30,000</td></tr><tr><td>$1,199</td><td>30,001 to 40,000</td></tr><tr><td>$1,599</td><td>40,001 to 60,000</td></tr><tr><td>$2,249</td><td>60,001 to 100,000</td></tr><tr><td>$3,249</td><td>100,001 to 200,000</td></tr><tr><td>$4,499</td><td>200,001 to 999,999</td></tr></tbody></table>

***

### Adjusting your plan tier

Your tier automatically increases if your monthly engagements exceed your current tier threshold. If your store’s engagement drops, your tier doesn't automatically decrease. You can contact support if you want to discuss moving to a lower tier: [`quizkit@presidiocreative.com`](mailto:quizkit@presidiocreative.com).

***

## How you’re billed

Quiz Kit app fees are added to your regular Shopify invoice. Charges follow Shopify’s standard app-billing cycle. You can review your billing information in your Shopify admin under **Settings** > **Billing.**

Learn more about how [Shopify bills for third-party apps.](https://help.shopify.com/en/manual/your-account/manage-billing/billing-charges/types-of-charges/third-party-charges/app-charges)

***

## Cancel your Quiz Kit plan

You can cancel your Quiz Kit billing at any time.

**Steps**:

1. **Uninstall** the Quiz Kit app from the Shopify **Apps** section.
2. Remove leftover snippets if you embedded code manually (Use our [removal guide](https://support.quizkitapp.com/faqs/frequently-asked-questions/how-do-i-delete-the-quiz-kit-app)).

***

### Support

#### Need more information on our Enterprise options or custom quizzes?

Book a quick demo and we’ll walk you through high-volume features, custom quotas, and pricing—live and tailored to your store.

<a href="https://www.quizkitapp.com/pages/demo" class="button primary">Book a demo</a>

#### Pricing questions

Contact [`quizkit@presidiocreative.com`](mailto:quizkit@presidiocreative.com) or message us directly from the app admin.&#x20;


# Onboarding guide

Use this guide to orient yourself with Quiz Kit and the features to help you get started.

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](/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](/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](/getting-started/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](/getting-started/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.](/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.&#x20;

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.&#x20;

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.](/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](/building-a-quiz/results/results-logic)
* [Using AI for results](/building-a-quiz/results/fallback-results)
* [Customizing results pages](/building-a-quiz/results/results-template)
* [Creating logic jumps](/building-a-quiz/results/results-logic/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](/building-a-quiz/styling-and-designing-your-quiz).

{% hint style="success" %}
**Tip:**&#x20;

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.&#x20;

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

<figure><img src="/files/sWeTbiPj6AxkNrmqGEnE" 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](/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 ](/ai-shopping-assistant/what-is-ai-shopping-assistant)
* [Personalization](/advanced-settings/personalizing-your-quiz)


# Quiz strategy and goal setting

## Define your goal

Pick **one primary objective** and a KPI to match.

| Goal                    | Example KPI                   |
| ----------------------- | ----------------------------- |
| Product recommendations | Quiz conversion rate          |
| Drive subscriptions     | Subscription add-to-cart rate |
| Grow email/SMS list     | Lead capture rate             |

> **Example:**\
> *Beauty brand* – “Help shoppers find the right routine and lift add-to-cart.”\
> *CPG brand* – “Build meal bundles and drive recurring orders.”

***

## Know your audience

Ask: **“What decision is the shopper trying to make?”**

* Loop Earplugs → “Why are you buying earplugs?”
* OUAI Haircare → “Describe your hair type.”

Turn that question into your quiz title and intro.


# 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 or a pre-built template.&#x20;

## In this section:

* [Choosing a quiz start method](#choosing-a-quiz-method)
* [Building a quiz](#build-a-quiz)
  * [Option 1: Build a blank quiz](#option-1-build-from-a-blank-template)
  * [Option 2: Build from a template](#option-2-build-from-a-template)

***

## Choosing a quiz start method

You can start your quiz three ways:

* **Blank quiz:** Build entirely from scratch, giving you full control over questions, answers, and design.
* **Pre-built template:** Start with an example quiz to save time and inspiration, then customize it as needed.

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. From the drop down, select one of the following:
   1. [Create a blank quiz](#option-1-build-from-a-blank-template)
   2. [Create from a template](#option-2-build-from-a-template)

***

## Building a quiz

### Option 1: Build from a blank template

{% embed url="<https://www.youtube.com/watch?v=U-E91XqNYqw>" %}

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** > **Create a blank quiz**.
2. From the quiz builder, on the left-hand menu, click **Introduction**. This is the first page your customers encounter during the quiz.&#x20;
3. 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;
4. 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**.
5. Optional: You can add additional questions by following repeating step 3. You can also choose to add [additional pages ](/account-and-settings/quiz-builder/quiz/additional-page-types)such as **Transition page**, **Form field**, or **Email capture**.
6. When you're done, click **Save** to save your changes.

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

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

***

### Option 2: Build from a template

You can use a pre-built template as a starting point for your quiz. Templates provide examples of what’s possible within Quiz Kit and help you get started faster.&#x20;

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** > **Create from a template**.
2. Under each template, you can click:
   1. **View demo** to try a demo of the quiz template
   2. **Use template** to start building your quiz in the quiz builder

Once you click **Use template** on the template of your choice, you can proceed to:

* [Drafting questions and pages](/building-a-quiz/creating-a-quiz/draft-questions-and-pages)
* [Styling and designing your quiz](/building-a-quiz/styling-and-designing-your-quiz)
* [Publishing your quiz](/publish-and-launch/publishing-your-quiz)


# Draft questions and pages

Best practices for drafting questions for your quiz.

In this section you'll find best practices and suggestions for drafting quiz questions, building pages, and&#x20;

## How many questions should I ask?

We recommend drafting 5–7 key questions. If a quiz is too long, then customers have a higher chance of dropping off.&#x20;

Also, it's a good idea to keep questions conversational:

* “How would you describe your skin?”
* “What is your main skin concern?”
* “What is your age range?”

## Build your pages

**Intro Page:**\
Keep it simple: use a short headline that explains the benefit and one clear “Start Quiz” button. If most of your visitors are on mobile (95% or more), you can skip the intro.

**Questions:**\
Use images with text for lifestyle products. Use sliders for questions about preferences like price or strength.&#x20;

**Forms & Email:**\
Ask for an email only after showing some value (like "See your routine and get 10% off").

{% hint style="info" %}
**Note:**

Older quizzes have the email/SMS collection form set up from the quiz's **Settings** page, under the **Email / SMS Page** tab. Using this setting adds the page to the end of your quiz.&#x20;
{% endhint %}

**Results:**\
At minimum, show a main image, 1–3 recommended products, and a call-to-action to buy. If you’re selling high-end items, consider hiding prices until users are more interested.


# Collecting customer data

Learn how to set up email and phone number collection in your quizzes.

There are two ways to collect customer contact information in Quiz Kit quizzes:

* Use an **Email capture question** to collect email addresses, which are automatically added to your Customers list. You can also add additional **Phone**, **Name**, **Birthday** fields.
* Use a **Form field question** to collect multiple custom fields, which are contained in the quiz [Submission data](/analytics-and-optimization/using-submission-data). You can set up more broad information collection.

If your goal is to quickly set up a simple email collection popup, then you can start with the **Email signup offer template**, which comes preconfigured with an Email capture question.

{% hint style="info" %}
**Tip**

If you want to create a simple email signup popup, then start with the **Email signup offer template**. It’s a one-question quiz that already includes an Email capture question and is optimized for quick setup.&#x20;

Learn more about the [Email signup offer](/building-a-quiz/collecting-customer-data/email-signup-offer-template) quiz template.&#x20;
{% endhint %}

## In this section

* [Method overview](#method-overview)
* [Setting up your quiz to collect contact information](#setting-up-your-quiz-to-collect-contact-information)
  * [Set up an Email capture question](#set-up-an-email-capture-question)
  * [Set up a Form field question](#set-up-a-form-field-question)
* [Attaching customer answers to their profile](#attaching-customer-answers-to-their-profile)
* [Using collected customer data](#using-collected-customer-data)
  * [Using email marketing apps](#using-email-marketing-apps)

***

## Method overview

<table><thead><tr><th width="205.6484375">Method</th><th>Best for</th><th>Quick link</th></tr></thead><tbody><tr><td><strong>Email capture question</strong></td><td>Single field + optional phone/name/birthday</td><td><a href="/pages/jWG8O25tIduCqfeVWwfE">Setup guide</a></td></tr><tr><td><strong>Form field question</strong></td><td>Multiple custom fields (text, date, number)</td><td><a href="/pages/jWG8O25tIduCqfeVWwfE">Setup guide</a></td></tr></tbody></table>

***

## Setting up your quiz to collect contact information

### Set up an Email capture question

The question type **Email capture** is intended to collect any of the following information that you want: the customer's email, name, phone, and date of birth.

**Steps:**

1. From the quiz builder, click **+ Add page**.
2. Click **Email capture**.
3. Under **Content**, customize the **Heading** text to describe the information that you're asking for.&#x20;
4. Under **Fields**, the **Email** field is there by default. You can also click **+ Add field** and add any of the following: **Phone**, **Name**, **Birthday**.
5. Optional: Customize the settings under any fields that you added, such as placeholder text and if the field is required or not.
6. Click **Save**.

Customer email addresses that are input here are automatically added to your Shopify Customers list and marked as subcribed.

{% hint style="info" %}
**Hint:**&#x20;

**Enable fake emails validation** from the email field settings if you want customers to submit only real email addresses. You can also **Add a GDPR checkbox** from the question level settings.
{% endhint %}

### Set up a Form field question

You can collect the same customer contact information with the Form field question type.

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

Use the **Marketing property name (optional)** field to pass data to your third-party app of choice.
{% endhint %}

**Steps:**

1. From the quiz builder, click **+ Add page**.
2. Click **Form field**.
3. Under **Content**, customize the **Heading** text to describe the information that you're asking for.&#x20;
4. Under **Fields**, click **Field 1**.
5. Under **Content**, leave the **Type** of field as **Text** to collect customer emails in this field. Switch it to **Date** to collect a birthday, or **Number** to collect a phone number in this field.&#x20;
6. Add more fields to collect more information by clicking **+ Add field** and choosing the appropriate **Type**.
7. Optional: Customize the settings under any fields that you added, such as placeholder text and if the field is required or not.
8. Click **Save**.

If you collect email addresses with this method, then customer emails are saved in the [Submission](/analytics-and-optimization/using-submission-data) data, not added to the Shopify Customers list.

***

## Attaching customer answers to their profile

You can have customer data collected be sent to their customer profile so that you can use it for marketing and customer relationship management (CRM).

**Steps:**

1. From the quiz builder menu, click **Settings**.
2. Check **Attach answer names to subscribed customers as tags.**
3. Click **Save**.

***

## Using collected customer data

Email submissions are added to the [Shopify customers list](https://help.shopify.com/en/manual/customers/manage-customers) and the email marketing status is set to “Subscribed”. These customers have the tag “Quiz Kit app subscriber” so you can easily identify how they were added. You can also [create a customer segment for targeted marketing with apps like Klaviyo](https://help.klaviyo.com/hc/en-us/articles/115005080907-Use-Shopify-Tags-to-Filter-Customers).&#x20;

All customer answers including emails, phone numbers, birthdays, and names are saved in Quiz Kit's [Submissions](/analytics-and-optimization/viewing-submission-data) section under that particular quiz.

### Using email marketing apps

Quiz Kit integrates with the most popular email marketing apps. You can find more info about configuring integrations with these apps on our [Quiz Kit Integrations](/building-a-quiz/integrations) page.&#x20;

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

You can use the **Marketing property name (optional)** field to pass data to your third-party app of choice.
{% endhint %}


# Email signup offer template

Learn how to quickly create a one-question quiz to collect customer emails

When you start building a quiz, you can choose to start from a template. The **Email signup offer** is a template for a one-question quiz, designed to collect a customer’s email in exchange for a discount or offer. You can use this quiz template to help you grow your email list while also engaging customers and driving sales.

## Setting up the quiz

The quiz contains a single question and an email collection form that the customer fills out to receive their quiz result: most commonly a discount code they can use for checkout.

**Steps:**

1. From the Quiz Kit dashboard, click **Create a new quiz** > **Create from a template**.
2. Under **Email signup offer**, click **Use template**.
3. Customize your quiz as you'd like.
4. Click **Save**.

When you're done editing the quiz, you need to publish it so customers can find it.&#x20;

## Publishing the Email signup offer quiz

The **Email signup offer** template is built to publish as a pop up. It automatically launches either on the homepage, or all pages.

{% hint style="info" %}
**Note**&#x20;

You can only enable automatic launch for one quiz at a time. Enabling on a new quiz with disable any older quiz it's active on.
{% endhint %}

**Steps:**

1. After customizing the quiz, from the Quiz builder, click **Publish**.
2. Under **Ready to publish**, click the drop-down and select the theme you want to publish to, then click **Publish**.
3. In the theme editors, under the **App embeds**, toggle the Quiz Kit **Auto-launch quiz** embed on.
4. Configure the pop up from the theme settings. You can then edit:
   1. **Trigger type:** Set when and how the popup launches to a new customer.
   2. **Show on:** Choose **All pages** or just the **Homepage**.
5. Click **Save**.

#### After submission

* Captured emails are added to your Shopify **Customers** list as subscribed.
* Customers can be shown a discount code, redirected to a page, or both.
* The quiz can integrate with your email marketing platform as configured in your store settings.

### Tips and best practices

* Use clear, compelling copy for your reward so customers know what they're signing up for.
* Consider timing your popup to avoid interrupting the customer too early
* Ensure GDPR/compliance notices are displayed if required.


# Sending quiz results to customers by email

You can set up Quiz Kit to automatically email your customers their quiz results when they’ve finished taking your quiz. This feature is customizable, and you can tailor the content and layout of the email to align with your brand.

## In this section

* [Before you begin: Adding email capture to your quiz](#before-you-begin-adding-email-capture-to-your-quiz)
* [Enabling quiz result emails](#enabling-quiz-result-emails)
* [Customizing the email layout](#customizing-the-email-layout)
* [Previewing a test email](#previewing-a-test-email)
* [Routing email replies to your own email account](#routing-email-replies-to-your-email-account)

***

## Before you begin: Adding email capture to your quiz

If you want to send email results to your customers, then first you need to add a page in your quiz to allow them to input their email address.&#x20;

**Steps:**

1. From the Quiz Kit app dashboard, click **Customize** on the quiz that you want to set up email capture for.
2. From the default Quiz menu, click **Add page**, then click **Email capture** from the list. The default email capture template displays.&#x20;
3. **Optional:** You can customize the template using the **Content** and **Fields** sections according to your preference.&#x20;
4. Click **Save**.

{% hint style="info" %}
**Note:**&#x20;

For GDPR reasons you can make this question optional to your customer by checking **Enable ability to skip this question**. You can also check **Enable fake emails validation** to minimize the possibility of fake email submission.
{% endhint %}

***

## Enabling quiz result emails

When you've finished setting up your quiz to collect customer emails, you need to turn on the email results feature from the quiz’s settings.&#x20;

You can send email results via Mailchimp or Klaviyo.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Advanced** plan or higher.
{% endhint %}

**Steps:**

1. From the Quiz Kit app, click **Customize** on the quiz you want to set up emailing results for.
2. From the left-hand menu, click the gear wheel to access the **Settings** menu.
3. Click **Results email template**.
4. Under **Display settings**, check **Send customer results via email**.
5. **Optional:** You can edit the [display settings and language](#customizing-the-email-layout) of the email on this page.
6. Click **Save**.

By default, quiz result emails are sent from our "**Quiz Kit ‑ Shoppable Quizzes**" email, [`hello@quizkitapp.com`](mailto:hello@quizkitapp.com).

{% hint style="info" %}
**Note:**&#x20;

Ensure that your email file size doesn’t exceed 20MB, and image's resolution doesn’t exceed 4472 x 4472 pixels.
{% endhint %}

***

## Customizing the email layout

You can customize the display settings and language of the email to match your branding and messaging.

### Language settings

**Email subject**

* This is the subject line that appears in the customer's inbox. You can edit it to better reflect your brand's voice or the quiz's theme.
  * **Default wording**: "Here are your quiz results"

**Email title**

* This is the title that appears at the top of the email body. You can personalize this to include your brand name or a custom thank-you message.
  * **Default wording**: "Thanks for completing our quiz! Here are your results"

**Email description**

* This section allows you to add a brief message or introduction before displaying the quiz results.

### Display settings

You can choose to include the following sections in your email:

**Show discount code section**

* **Toggle on**: This displays a discount code within the email.
* Customize the following:
  * **Discount title**: "Here Is Your Discount Code"
  * **Discount description**: "Save this code and use on checkout"
  * **Discount button label**: "Shop Now"
  * **Discount button URL**: Add the URL where the customer can redeem their discount.

**Show customer responses section**

* **Toggle on**: This displays the customer's answers to the quiz questions in the email.
* Customize the following:
  * **Responses title**: "Your responses"

**Show retake quiz section**

* **Toggle on**: This gives the customer the option to retake the quiz.
* Customize the following:
  * **Retake quiz title**: "Want to try the quiz again?"
  * **Retake quiz button label**: "Retake Quiz"

### Product Recommendations

You can also include a section in the email for product recommendations based on the quiz results:

**Products title**

* **Default wording**: "Recommended Products"
* Customize this title to match your product offerings or brand tone.

**Products button label**

* **Default wording**: "Buy now"
* Customized this label to prompt customers to take action, for example "Shop Now" or "Add to cart."

***

## Previewing a test email

Once you've configured the settings to your preference, test the email by taking the quiz yourself on your website. The user flow is from the email capture page, to the results page on your website, and then the email is triggered.

Quiz results are sent to the email address you input into the quiz's email capture field.&#x20;

***

## Routing email replies to your email account

By default, if your customer replies to a quiz result email, that email is routed to a no-reply email address at Quiz Kit. If you want to route email replies to your own email account, you need to configure the DNS records for your domain.

### Configuring DNS records

{% hint style="warning" %}
**Caution:**&#x20;

Misconfiguring DNS records can result in customer replies being misrouted or undelivered. Follow the instructions carefully and verify all settings with your DNS provider.
{% endhint %}

**Steps:**

1. **Verify domain access**
   * Create a TXT record in your domain's DNS settings to verify that you have access to the email account or TXT records for your domain. Use the following value for the TXT record: `mandrill_verify.RaP4jujb9G14ilYVNVPSlA`.
2. **Set up CNAME records for email routing**
   * To properly route email replies to your server, create two CNAME records in your DNS:
     1. **Record 1:** Name: `mte1._domainkey.4frnt.com`, Value: `dkim1.mandrillapp.com`
     2. **Record 2:** Name: `mte2._domainkey.4frnt.com`, Value: `dkim2.mandrillapp.com`
3. **Configure DMARC Record**
   * Create a TXT record in your DNS with the host `_dmarc.cardonformen.com` and the following value: `v=DMARC1; p=none;`. This ensures that email replies are correctly routed to your email server.

When you’ve correctly set up your domain’s DNS settings, any customer replies to quiz results emails are sent directly to your email server.


# Sending quiz results to customers via Klaviyo

Learn how to create an email with quiz results in Klaviyo.

You can send your customers their quiz results using Klaviyo.&#x20;

This page details the steps of creating the email trigger in Klaviyo, the email's dynamic table, and the variables that you need to know to set up the dynamic content.&#x20;

{% hint style="warning" %}
**Caution**:&#x20;

To set up this feature, you need to be familiar with [custom variables](https://help.klaviyo.com/hc/en-us/articles/4408802597659#01FJZ2C75YSBRKE8DN87SG9R44) and [email flows](https://help.klaviyo.com/hc/en-us/articles/115002774932-Getting-Started-with-Flows#create-a-new-flow4) in Klaviyo.
{% endhint %}

## In this section <a href="#id-01fjz2c75yes3qpfrfgrxj8jex" id="id-01fjz2c75yes3qpfrfgrxj8jex"></a>

* [Before you begin](#before-you-begin)
* [Setting up the email in Klaviyo](#id-01fjz2c75yes3qpfrfgrxj8jex-1)
  * [Step 1: Create the trigger](#step-1-create-the-trigger)
  * [Step 2: Add the email template and table](#step-2-add-the-email-template-and-table)
  * [Step 3: Edit the dynamic table](#step-3-edit-the-dynamic-table)
* [Previewing your email](#id-01fjz2c75ynwaktks70450ncs7)
* [Showing your products using custom code](#how-to-show-your-products-using-custom-code)

***

## Before you begin

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Basic** plan or higher.
{% endhint %}

Before you start setting up your email flow and dynamic blocks, you need to ensure you have completed the following:

* You have successfully [integrated Klaviyo with your Shopify store](/building-a-quiz/integrations/email-and-sms/klaviyo).&#x20;
* You have connected[ a Klaviyo mailing list](/building-a-quiz/integrations/email-and-sms/klaviyo#passing-quiz-submissions-to-your-klaviyo-list).
* At least one customer has completed the quiz so that custom properties start appearing. Once a customer profile gets created, their custom properties appear.
* Familiarize yourself with [Klaviyo's help doc and dynamic variables](https://help.klaviyo.com/hc/en-us/articles/4408802597659#01FJZ2C75YSBRKE8DN87SG9R44). You need them for this tutorial.

When you have successfully set up the email to use dynamic data, Quiz Kit passes you the following variables:&#x20;

* Result name (If results are AI generated, results name is `AI fallback`)
* Quiz name
* Quiz completion date
* Customer answers
* Discount code
* Products recommended
* Result URL

Familiarize yourself with [this doc](https://help.klaviyo.com/hc/en-us/articles/115005084927-Template-Tags-and-Variable-Syntax#custom-properties2) to see how to use these variables.

***

## Setting up the email in Klaviyo <a href="#id-01fjz2c75yes3qpfrfgrxj8jex" id="id-01fjz2c75yes3qpfrfgrxj8jex"></a>

After you've connected Klaviyo and have custom properties for your quiz, you can set up the flow and dynamic content in Klaviyo. [Learn more about how to add a dynamic table and metric-triggered flow in Klaviyo](https://help.klaviyo.com/hc/en-us/articles/4408802597659#01FJZ2C75YSBRKE8DN87SG9R44).

### Step 1: Create the trigger

1. From your Klaviyo dashboard, click **Flows**.
2. Click **Create Flow**.
3. Click **Build your own**.
4. Name your flow and click **Create Flow**.
5. Under **Select a trigger***,* click the **Your Metrics** tab, then click **API**.
6. Choose the event that should trigger your flow. Click **Quiz Completed** to trigger the email to be sent when the customer completes your quiz.
7. Click **Save**, then **Confirm and save.**

### **Step 2: Add the email template and table**

1. Under **Actions**, drag and drop the **Email** action into the flow.
2. Click the email, and in the right-hand menu, enter your email details.
3. Click Select template, choose one of the templates, then click **Use template**.&#x20;
4. From the left-hand menu under **Blocks**, drag and drop the **Table** block.
5. From the left-hand menu, click the **Styles** tab.
6. Under **Data**, click **Dynamic**.
7. In the **Row collection** text field, copy and paste `event.Products`.
8. In the **Row alias** text field, copy and paste `item`.
9. Click the **Content** tab.

### Step 3: Edit the dynamic table

{% hint style="info" %}
**Note**:&#x20;

To complete this step, you need to understand Klaviyo's custom variables.&#x20;

[Learn more about custom variables](https://help.klaviyo.com/hc/en-us/articles/4408802597659#01FJZ2C75YSBRKE8DN87SG9R44), or [contact Klaviyo support](https://www.klaviyo.com/contact-us) for questions.&#x20;
{% endhint %}

1. Click the **Content** tab to return to the table content editor.
2. Click on **Dynamic row** **1** or **2**, then click **Text** or **Image** to change the cell type.
3. Add any dynamic product variables that you want to include to the table.&#x20;

Below is an example of code for showing the "Result title": `{{ person | lookup: 'Result title' | default: '' }}`. You can set default value inside of '' if needed.

<figure><img src="/files/zAUeQcUWCIDfIyvkRquj" alt=""><figcaption></figcaption></figure>

***

## Previewing your email <a href="#id-01fjz2c75ynwaktks70450ncs7" id="id-01fjz2c75ynwaktks70450ncs7"></a>

When you've set up the email flow and dynamic table, you should preview and test the email to ensure it works as expected. To do so, from the Klaviyo email editor, click **Preview & test**.&#x20;

When you've ensured everything is working correctly, click **Done**.

{% hint style="info" %}
**Note**:

If there are any errors, check the spelling and structure of your variables, as well as your **Table Settings** tab.
{% endhint %}

***

## Showing your products using custom code <a href="#how-to-show-your-products-using-custom-code" id="how-to-show-your-products-using-custom-code"></a>

{% hint style="warning" %}
**Caution:**\
\
**For advanced users.** You need to be knowledgeable in coding to complete these steps.
{% endhint %}

To loop through the products and display the correct data, you need to use the "for" cycle: `{% for product in person.Products %}{{ product.title }}` - `{{ product. price }}{% endfor %}`&#x20;

In each product you can display:&#x20;

1. `product.title`
2. `product.price`&#x20;
3. `product.link`
4. `product.image`
5. `product.id`


# Styling and designing your quiz

Style and customize your quiz's appearance and elements.

You can change the style and options of your quiz in Quiz Kit minimally, or in detail. You have different options for how you'd like to style and customize, from in-app presets to custom code.

## In this section:

* [Styling with a template](#styling-with-a-template)
* [Styling in the quiz builder interface](#styling-in-the-quiz-builder-interface)
* [Advanced settings](#advanced-settings)
* [Custom CSS/Javascript](#custom-css-javascript)

## Styling with a template

If you build your quiz with a template, then in the initial quiz setup flow you can choose from a selection of preset theme styles and options without any extra effort.

These templates are starting points that can be further customized in the quiz builder.

## Styling in the quiz builder interface

If you want to adjust the look and feel of your quiz in more detail, then you can also use the **Styles** menu in the quiz builder. You can change typography, buttons, input fields, tool tips, and the progress bar.&#x20;

You can also make customizations to the questions, answers, and results that you set up for your quiz.\
\
Learn more about [styles in the quiz builder.](/account-and-settings/quiz-builder/styles)

***

## Advanced settings

In any quiz, you can adjust advanced settings. Advanced settings can help you customize certain features, such as [personalizing your quiz for customers](/advanced-settings/personalizing-your-quiz), or [adding a discount code to your quiz](/faqs-and-support/frequently-asked-questions#how-do-i-add-a-discount-code-to-my-quiz). \
\
You can learn more about advanced settings in the [Frequently asked questions section](/faqs-and-support/frequently-asked-questions), and in the **Advanced settings** section of the Help Center.

***

## Custom CSS/JavaScript

Additionally, if you're knowledgeable about code, then you can also add your own custom JavaScript and CSS from within the quiz builder or in your theme editor.\
\
Learn more about [applying custom CSS and JavaScript to your quizzes.](/faqs-and-support/frequently-asked-questions#how-can-i-add-my-own-custom-css-and-javascript-to-quiz-kit)


# Style settings

Learn how to edit and update global and page-specific style settings.

You can apply different style settings to your quiz both locally (at the question and answer level), and also globally (to the entire quiz).&#x20;

## In this section

* [Global style settings](#global-style-settings)
  * [Button styles](#button-styles)
* [Page-specific controls](#page-specific-controls)

***

## Global style settings

These settings are applied to every page.&#x20;

<table><thead><tr><th width="144.8203125">Setting</th><th width="287.9609375">What you can style</th><th width="248.55078125">Best practicies</th></tr></thead><tbody><tr><td><strong>Typography</strong></td><td>Use live theme fonts or pick custom fonts; separate font styles for headings, body, accent, and tooltips.</td><td>Stick to two fonts to keep your website loading fast.</td></tr><tr><td><strong>Colors</strong></td><td>General color palette, and specific colors for form fields and tooltips.</td><td>Use brand colors and high-contrast combinations to support accessibility.</td></tr><tr><td><strong>Buttons</strong></td><td>Button font, opacity, corners, colors. </td><td>Use a contrasting hover color to signal tap.</td></tr><tr><td><strong>Input fields</strong></td><td>Border radius, GDPR text alignment.</td><td>Keep placeholder copy friendly (“Your email here”).</td></tr><tr><td><strong>Tooltip</strong></td><td>Icon position, heading and description text alignment. </td><td>Use for clarifying terminology or next steps.</td></tr><tr><td><strong>Custom CSS</strong></td><td>Custom styling and overrides.</td><td>Use sparingly.</td></tr></tbody></table>

### Button styles

You can customize up to three different button styles to control how buttons look in your quiz: Primary, secondary and tertiary.&#x20;

You can:

* **Set styles globally** so all your pages use the same button styles
* **Customize styles locally** on individual questions or pages when you want a more nuanced level of customization

If you choose to customize only the global button styles, here's what they apply to throughout the quiz:

* **Primary** – answer buttons
* **Secondary** – start quiz button
* **Tertiary** – navigation buttons, like Next and Back

This setup helps you keep your quiz consistent, but still gives you flexibility when you need it.

***

## Page‑specific controls

Fine‑tune each step of the journey.

<table><thead><tr><th width="180.390625">Page</th><th>Adjustable elements</th></tr></thead><tbody><tr><td><strong>Intro</strong></td><td>Heading, subheading, button, and main image, custom JavaScript</td></tr><tr><td><strong>Questions</strong></td><td><p>Question format, options to show image and bullets, marketing property name, progress bar toggle, ability to select multiple answers, ability to skip the question, and custom JavaScript.</p><p></p><p>Question heading, description, bottom text, image, tooltip heading and description.</p></td></tr><tr><td><strong>Answers</strong></td><td>Image shape, color, size, style, text alignment, custom URL redirect checkbox.</td></tr><tr><td><strong>Forms and email</strong></td><td>Heading, description, bottom text, button label, image, tooltips, field type, name, placeholder, skip question toggle, hide field names toggle, GDPR checkbox, fake‑email validation, custom JavaScript.</td></tr><tr><td><strong>Results (General)</strong></td><td>Show/hide “Add to Bag”, “Add All”, “Retake Quiz”.</td></tr><tr><td><strong>Results (Products)</strong></td><td>Full‑width CTA, quantity picker, info toggles, variant display, and image rules.</td></tr><tr><td><strong>Progress indicators</strong></td><td>Layout, number of questions per step, navigation text, next/back buttons, show arrow checkbox.</td></tr></tbody></table>


# Adding custom code to quizzes

Learn to apply custom code like CSS and JavaScript to your quizzes to customize them.

You can apply your own custom CSS and JavaScript code to your Quiz Kit quizzes. There are several methods to apply custom code: through the custom fields in the quiz builder, in your theme editor, and in each published quiz’s page.

{% hint style="warning" %}
**Caution**

You should only edit your theme's code if you're familiar with coding. Adding CSS and JavaScript through the Quiz Kit app builder is the easiest and least risky way to make changes.
{% endhint %}

## In this section:

* [Applying custom CSS to your quiz](#applying-custom-css-to-your-quiz)
* [Applying custom JavaScrip](#applying-custom-javascript)[t to your quiz](#applying-custom-javascript)

***

## Applying custom CSS to your quiz

### Option 1: Applying custom CSS in the quiz builder

You can add custom CSS to your quiz from the **Styles** menu. When you use this method, it applies the CSS code to the entire quiz.

**Steps:**

1. From the Quiz Kit dashboard, click **Customize** on the quiz that you want to apply custom CSS to.
2. On the left-hand menu, click the paintbrush to access the **Styles** menu, then click **\</> Custom CSS**.
3. On the right-hand menu, enter your custom CSS in the given field, then click **Save**.

### Option 2: Applying custom CSS to your theme file

When you add custom CSS to your quiz kit theme file, you can choose to apply it to all quizzes, or just specific quizzes.

{% hint style="warning" %}
**Note:** Don't apply CSS code to div classes as they're dynamic and can change.
{% endhint %}

**Steps:**

1. From your Shopify admin, go to **Online Store > Themes.**
2. Find the theme that you want to edit, click the **…** button to open the actions menu, and then click **Edit code**.
3. Search within the theme for the quiz kit file.
4. Enter the CSS code into the file. You can add custom CSS to your quiz element IDs, tags, or other attributes. Don't apply it to classes as they're dynamic and can change.&#x20;
5. Click **Save**.

{% hint style="info" %}
**Note:** You can find the quiz elements that you might need like IDs, tags, and attributes by inspecting the page in your browser.
{% endhint %}

<figure><img src="/files/aRlmfWnCH9t3LHyP9uPw" alt=""><figcaption></figcaption></figure>

### Option 3: Applying custom CSS to your quiz's page&#x20;

**Steps:**

1. From the Shopify dashboard, click **Online Store > Pages**.
2. Click the quiz page that you want to edit CSS for.
3. Click **\</>** on the Rich Text Editor to show the page code.
4. Add your custom CSS and click **Save**.

You can also explore examples of [common custom CSS and HTML code.](/advanced-settings/common-code-customizations#adding-custom-code)

***

## Applying custom JavaScript to your quiz

### Option 1: Applying custom JavaScript in the quiz builder

You can add your own JavaScript to your quizzes Intro, Question, or Result pages. Custom JavaScript only applies to the specific page it's used on.

**Steps:**

1. From the Quiz Kit dashboard, click **Customize** on the quiz that you want to customize.
2. Click the page that you want to add custom JavaScript to.
3. On the right-hand menu, find the **Custom JS** field.
4. Add any quiz elements like IDs, tags or other attributes. Don't apply it to classes as they're dynamic and can change.
5. Click **Save.**

### Option 2: Applying custom Javascript in your theme file

You can add JavaScript in your theme file, but it will only apply to the pages of your quiz that you specify. You can use [custom JavaScript events](#custom-javascript-events) listed below.

**Steps:**

1. From your Shopify admin, go to **Online Store > Themes.**
2. Find the theme that you want to edit, click the **…** button to open the actions menu, and then click **Edit code**.
3. Search within the theme for the quiz kit file.
4. Enter the JavaScript code into the file.&#x20;
5. Click **Save**.

You can also explore examples of [common custom JavaScript events](/advanced-settings/common-code-customizations#common-custom-javascript-events).


# Results

Learn about the options you have when setting up your quiz results.

Setting up results is one of the most important steps in building your quiz. Quiz Kit uses AI to generate product recommendations based on your store data, and you can guide it with your own rules, add [manual result](/building-a-quiz/results/results-logic) paths for specific paths, or use a combination of both.

Manual results give you control over specific paths, while AI results handle everything else. Together they ensure every quiz taker gets a result.

Manual results always override AI results, so you can mix fully manual outcomes with AI outcomes as needed. You can also edit your results page with custom content in the [results template](/building-a-quiz/results/results-template) section.

## In this section

* [AI results](#ai-results)
* [Manual results logic](#manual-results-logic)
* [Fallback results](#fallback-results)
* [Results page customization](#results-page-customization)

***

## AI results

When you set up results for a new quiz, you choose between two AI-powered modes: **AI results** and **AI + manual results**. Both use AI to generate recommendations from your store data. AI + manual results also lets you define specific result paths yourself.

Learn more about [AI results](/building-a-quiz/results/ai-results).

***

## Manual results logic

If you want full manual control over your quiz results, you can set up manual results logic to define exactly what products are recommended for specific answer paths.

Learn more about [Results logic](/building-a-quiz/results/results-logic).

***

## Fallback results

Fallback results ensure every quiz path returns an outcome, even if you haven't manually defined results for that path. By default, fallback results are AI generated, but you can adjust this how you want.

Learn more about [fallback results](/building-a-quiz/results/fallback-results) and [outcome types](/building-a-quiz/results/outcome-types).

***

## Results page customization

Once your results are defined, you can customize how they appear to customers.

Use the results template to control the layout, content, and design of your results page.

Learn more about [customizing the results template](/building-a-quiz/results/results-template).


# AI results

Learn about Quiz Kit's AI-powered results setup and how to choose the right approach for your quiz.

Quiz Kit uses AI to intelligently generate quiz results based on your quiz's questions and answers, your store data, and any rules you add to guide it.&#x20;

When you set up results for a new quiz, you choose how you want AI to work for you:

**AI results**: AI generates recommendations. You can add rules to guide it, or let it work on completely its own. This option is best if you have a very large catalog, or if you want to get started quickly.

**AI + manual results:** AI generates recommendations. You can add rules to guide it, and you can use [manual result logic](/building-a-quiz/results/results-logic#results-logic-types) to set up result paths you want direct control over. Manual paths always take priority over AI results.

AI results vary based on your store data and any rules you add.

## In this section

* [Setting up AI results](#setting-up-ai-results)
  * [Choose a results mode](#choose-a-results-mode)
  * [Add results rules (optional)](#add-results-rules-optional)
  * [Review your results rules](#review-your-results-rules)
  * [Test your results](#test-your-results)
* [Setting up manual results](#setting-up-manual-results)
  * [Add manual result paths](#add-manual-result-paths)
  * [Switch between results modes](#switch-between-results-modes)
* [Customizing the results page](#customizing-the-results-page)

***

## Setting up AI results

By default, Quiz Kit syncs your store's products, metafields, pages, and quiz questions and answers to generate recommendations. This means you don't need to manually select products for AI to consider. It draws from your full catalog to find the best matches for each quiz taker.

You can use results rules to guide AI, and manual result logic to override any specific paths, or you can leave AI to fully control the results.

### Choose a results mode

When you first set up results for a new quiz, Quiz Kit asks you to choose between **AI results** and **AI + manual results**. This determines whether you'll have the option to add manual result paths later in your setup. You can switch modes at any time.&#x20;

**Steps:**

1. From the quiz builder, click **Results** in the left-hand menu.
2. Choose a results mode:
   1. **AI results**: AI generates results from your store data. Add rules to guide it, or let it work on its own.
   2. **AI + manual results:** Set up AI results first, then manually set up paths you want direct control over.
3. Watch the video tutorial to learn more, then click **Continue**.

### Add results rules (optional)

You can set up results rules to help guide AI. The rules help AI decide what to generate for product recommendations, and are categorized as an **Exclude** rule or a **Recommend** rule. You can describe in plain language what to recommend, what to avoid, and any special cases. You can also test your quiz's AI results first and then come back to create, edit or delete rules later if needed.&#x20;

This step is optional for both modes. If you skip it, AI generates results from your data on its own.&#x20;

If you switch between modes, any rules you create are still saved.

**Steps:**

1. Under **Enter results instructions (optional)**, use the text field to enter any rules you want.
2. Click **Generate rules**.

### Review your results rules

AI compiles a list of rules to show you how it interpreted them. You can review, edit or delete rules in this step.

**Steps:**

1. Do one of the following:
   1. To edit a rule, click the pencil icon, adjust the text, then click **Save**.&#x20;
   2. To delete a rule, click the trash can icon, then click **Delete**.
2. When you're done reviewing the rules, click **Continue**.

### Test your results

Before publishing, walk through your quiz as a customer would to check which results are returned for specific paths. This applies to both modes.&#x20;

If results don't look right, then you can adjust your rules or add manual result paths for specific paths you want direct control over later.

{% hint style="info" %}
**Tip**

You can use the path selector in the quiz preview window to quickly change the question and answer path that you're testing results for. Click **Change path** at the top of the window, select a different answer combination, and click **View results**.
{% endhint %}

**Steps:**

1. Click **Preview quiz**.
2. Click through the quiz to get to the result like a customer would.
3. Optional: Click **Retake quiz** to test multiple answer paths, or click **Change path** to quickly change the path you're testing results for.
4. Do one of the following:
   1. If the quiz results look good, click the **Looks good** button in the bottom banner.
   2. If the quiz results need more rules guidance or manual paths, click **Needs fixing**.

If you click **Needs fixing**, you return to the **Results rules** editor where you can continue to add more rules or edit the ones you have.

***

## Setting up manual results

### Add manual result paths

You can set up the exact products to recommend for a specific quiz path, overriding AI for that path. This is available in **AI + manual results** mode.&#x20;

Manual result paths always take priority over AI results.

**Steps:**

1. From the results builder, click **Editor** at the top to switch to the results editor.
2. Choose a [results logic type](/building-a-quiz/results/results-logic). This determines how your quiz maps answers to results. You can change your logic type at any time.
3. From the left-hand menu, click **+ Add result**.
4. Follow the setup steps for your chosen logic type.

Learn more about [results logic types](/building-a-quiz/results/results-logic) and [outcome types](/building-a-quiz/results/outcome-types).

### Switch between results modes

You can switch between results modes any time and you won't lose any rules you've created.

**Steps:**

1. From the results builder page, at the top of the left hand menu, you see your results mode next to **Results**.
2. Click the current results mode to open the drop down.
3. Click the mode you want to switch to.

***

## Customizing the results page

Review the [Results template](/building-a-quiz/results/results-template) page to learn more about customizing the results page.


# Results logic

Learn about the different recommendation logic types that you can use to manually create results mapped to your quiz questions.

When you build a quiz from a blank template, you can allow AI to generate results, or you can set up the results logic for the quiz. The results logic is how you control how the quiz recommends products or results to customers based on their answers to questions.&#x20;

There are six types of results logic that a quiz can have: Basic, Single, Points, Product weight, Result weight, and Combination.

{% hint style="success" icon="lightbulb-exclamation-on" %}
**Tip**

You can use [AI-generated Fallback results](/building-a-quiz/results/fallback-results) for any results paths you don't cover with the manual logic.
{% endhint %}

## In this section

* [Changing the results logic](#changing-the-results-logic)
* [Results logic types](#results-logic-types)
  * [Basic (default)](#basic-default)
  * [Single](#single)
  * [Points](#points)
  * [Product weight](#product-weight)
  * [Result weight](#result-weight)
  * [Combination](#combination)
* [Fallback results](#fallback-results)
  * [AI Fallback results](#ai-fallback-results)
* [Setting a recommended products limit](#setting-a-recommended-products-limit)
* [Excluding products from results](#excluding-products-from-results)

***

## Changing the results logic

You can adjust the results logic on any quiz that has been created with a blank template.

**Steps:**

1. From the quiz builder, click **Settings.**
2. On the left-hand menu, click **Recommendations**.&#x20;
3. Under **Results Logic**, click the drop-down menu for logic options, and click the one you want to switch to.&#x20;
4. Click **Save**.

***

## Results logic types

{% embed url="<https://www.youtube.com/watch?v=sI2gqAEJxaM>" %}

### Basic (default)

With basic logic, results are mapped to an answer path that the customer has to select to reach that result. In other words, the customer needs to select certain answers to each question to end up with a specific result.&#x20;

This option requires you to manually link a series of questions and answers to products that are recommended on the results page.&#x20;

[Learn more about the Basic logic type](/building-a-quiz/results/results-logic/basic-logic-default).

### Single

The [Single logic type](/building-a-quiz/results/results-logic/single-logic) recommends products for each answer that a customer chooses. If you have multiple questions in your quiz, then the customer will likely end up with multiple product recommendations at the end.\
\
You can [set a limit for the number of products](#setting-a-recommended-products-limit) that you want to recommend in the results.

[Learn more about the Single logic](/building-a-quiz/results/results-logic/single-logic)[ type](/building-a-quiz/results/results-logic/single-logic).

### Points

The [Points logic type](/building-a-quiz/results/results-logic/points-logic) recommends results for a certain sum of points that a customer accumulates from each answer they choose.&#x20;

You need to set the number of points that each answer is worth, and then you need to set the range of points that a customer needs in order to be recommended a certain result.

[Learn more about the Points logic type](/building-a-quiz/results/results-logic/points-logic).

### Product weight

The [Product weight logic type](/building-a-quiz/results/results-logic/product-weight-logic) is based on the weight assigned to each product at the answer level. Products are recommended in the results based on which product accumulated the most weight (numerical value) by the end of the quiz.\
\
Instead of creating answer paths, you directly link questions with products on the question creation page and allocate a specific weight to each product.

[Learn more about the Product weight logic type](/building-a-quiz/results/results-logic/product-weight-logic).

### Result weight

The [Result weight logic type](/building-a-quiz/results/results-logic/result-weight-logic) suggests products based on their frequency of being chosen as an answer.&#x20;

Instead of opting for answer paths, you directly link answers with results on the question creation page. When an answer is chosen, it will assign additional points to that result.

At the end of the quiz, the product with the highest point accumulation is recommended. Each answer can only be associated with a single result.

[Learn more about the Result weight logic type](/building-a-quiz/results/results-logic/result-weight-logic).

### Combination

The [Combination logic type](/building-a-quiz/results/results-logic/combination-logic) is a combination of the Basic and Single logic types. The results are shaped by both the individual answers provided (Single logic), but also by the combination of the answers (Basic logic).

You can [set a limit for the number of products](#setting-a-recommended-products-limit) that you want to recommend in the results.

[Learn more about the Combination logic type](/building-a-quiz/results/results-logic/combination-logic).

***

## Fallback results

Your **Fallback result** is like a safety net: It displays outcomes if a customer navigates through a question and answer path that's not set up with manual results logic.&#x20;

You can choose from multiple types of **Outcomes** in the **Fallback results** section of the **Results** menu such as:

* [AI-generated](#ai-fallback-results)
* Products
* Collections
* Tags
* Text
* URL redirect

### AI Fallback results

AI-generated Fallback results use AI to collect your store data and provide the best recommendations for their quiz answers. This helps ensure that your customers receive accurate recommendations, regardless of their quiz results.&#x20;

Learn more about [AI-generated results](/building-a-quiz/results/fallback-results).

***

## Setting a recommended products limit

You can set a limit on how many products are recommended in the results for certain logic types.

**Steps:**

1. From the quiz builder, click **Settings**.
2. On the left-hand menu, click **Recommendations**.
3. In the text box under **Recommended products limit**, enter the maximum number of products that you want to show on the quiz results page. Leave the field blank if you want to remove the limit.
4. Click **Save**.

***

## Excluding products from results

You can exclude certain products from the quiz results, even if they otherwise fit the recommendation criteria for certain logic types.

**Steps:**

1. From the quiz builder, click **Settings**.
2. On the left-hand menu, click **Recommendations**.
3. Check **Exclude products**.
4. Click **Save**.
5. Navigate to the quiz builder's main **Quiz** page.
6. Click a question, then an answer that you want to exclude products for.
7. On the right-hand menu, click **Select excluded products**.
8. Check all of the products that you want to exclude.
9. Click **Save and close**, then click **Save**.

***

## Additional recommendations settings

In the **Recommendations** menu settings, you can also enable or disable the following options:

* **Open products in a new window**: Clicking product results at the end of a quiz opens a new window.
* **Show only in-stock products**: Only products that are in stock are recommended on the results pages.
* **Ignore store's currency format**: If you have an issue with the currency formatting from a third-party app, checking this option ignores your store's default currency.
* **Show additional settings in the Product section**: Additional settings are shown in the product section in the product results section of the quiz builder such as:&#x20;
  * Enable images swipe on mobile
  * Enable products swipe on mobile
  * Show type
  * Show product featured image instead of variant image
  * Show product second image instead of variant image
  * Hide "Add to bag" button
  * Hide price
  * Hide links from product image and title


# Basic logic (default)

Learn about the Basic results logic type for quiz results.

By default, a newly created quiz with a blank template is set up with the Basic logic type.

With Basic logic, results are mapped to an answer path that the customer has to select to reach that result. In other words, the customer needs to select certain answers to each question to get a specific result.

This option requires you to manually link a series of questions and answers to products that are recommended on the results page.

## In this section:

* [Changing the results logic type](#changing-the-results-logic-type)
* [Choosing a result outcome type](#choosing-a-result-outcome-type)
* [Setting up Basic logic results](#setting-up-basic-logic-results)
  * [Setting up a result outcome](#step-1-setting-up-a-result-outcome)
  * [Setting up a result path](#step-2-setting-up-a-result-path)

***

## Changing the results logic type

You can adjust the results logic on any quiz that has been created with a blank template. If you have previously switched your results logic type, then you will need to switch it back to Basic logic.&#x20;

**Steps:**

1. From the quiz builder, click **Settings.**
2. Click **Recommendations**.&#x20;
3. Under **Results Logic**, click the drop-down menu for logic options, and click **Basic (default).**&#x20;
4. Click **Save**.

***

## Choosing a result outcome type

For a Basic logic result you can choose from several different outcome types. When you set up a new path, you need to set up the outcome type under the **Outcome** section.

* **Product:** Provide product suggestions tailored to your customers' responses.&#x20;
* **Collection**: Provide a specific collection of products tailored to your customers' responses.
* **Tags:** Choose tag(s) to be assigned to your customer according to their responses.&#x20;
* **Text:** Write a message to appear on the results page according to your customers' responses.
* **URL redirect**: Based on their responses, the customer will be redirected to [a specific URL](/analytics-and-optimization/analytics-and-tracking/quiz-analytics/url-redirect-analytics).&#x20;

***

## Setting up Basic logic results

### Step 1: Setting up a result outcome

1. From the quiz builder menu, click the **Results** tab.
2. From the left-hand menu, click **Add result**, and give the result a name under **Result name** on the right-hand menu.
3. Click **Outcome**, and from the right-hand menu, select an [outcome type](#choosing-a-result-outcome-type) for this result path.
4. Select the results that you want displayed for this path.
5. Click **Save**.

### Step 2: Setting up a result path

1. From the left-hand menu, click **Path**.
2. From the right-hand menu, under each of your quiz questions, click **Choose an option**, and select the answers to that question that you want to lead to this outcome. You can add more than one.
3. Click **Save**.

You can repeat this process to create as many result outcomes as you want.

{% hint style="info" %}
If you have different results that have similar outcomes or paths, then you can save time by clicking the **Duplicate** button beside a result to duplicate it.&#x20;
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=ekyw1JFcLV8>" %}
How to set up basic result logic
{% endembed %}


# Single logic

Learn about the Single results logic type for quiz results.

The Single results logic type recommends products for every answer that a customer chooses. If you have multiple questions in your quiz, then the customer will likely end up with multiple product recommendations at the end.&#x20;

## In this section: <a href="#in-this-section" id="in-this-section"></a>

* [Changing the results logic type](#changing-the-recommendations-logic-type)
* [Setting up Single logic results](#setting-up-basic-logic-results)

***

## Changing the results logic type <a href="#changing-the-recommendations-logic-type" id="changing-the-recommendations-logic-type"></a>

You can adjust the results logic on any quiz that has been created with a blank template.&#x20;

**Steps:**

1. From the quiz builder, click **Settings.**
2. Click **Recommendations**.
3. Under **Results Logic**, click the drop-down menu for logic options, and click **Single.**
4. Optional: In the text box under **Recommended products limit**, enter the maximum number of products that you want to show on the quiz results page. Leave the field blank if you want to remove the limit.
5. Click **Save**.

***

## Setting up Single logic results <a href="#setting-up-basic-logic-results" id="setting-up-basic-logic-results"></a>

To have product recommendations display on the quiz results page, you need to set up products for the answers in your quiz at the answer level.

**Steps:**

1. From the quiz builder menu, click the **Quiz** tab.
2. From the left-hand menu, click the question, then the answer that you want to set up product recommendations for.
3. Under **Selected products**, click **Select products**.
4. Check all of the products that you want to be recommended for this quiz answer.
5. Click **Save and close**, then click **Save**.

Repeat this process to define product recommendations for all of the answers on your quiz that you want to recommend products for.

{% hint style="info" %}
You don't have to associate every answer with a product/products, if that answer doesn't impact the product recommendations. However, if none of the answers chosen have products associated with them, then the Fallback result is displayed at the end of the quiz.
{% endhint %}

{% embed url="<https://youtu.be/tW1lxn77NFo>" %}


# Points logic

Learn about the Points results logic type for quiz results.

The Points logic type recommends results based on a certain sum of points that a customer accumulates from each quiz answer they choose.&#x20;

You need to set point values for each answer, then create point value ranges for each result. Customers needs to accumulate a certain number of points with their answers to be recommended certain results.&#x20;

## In this section

* [Changing the results logic type](#changing-the-results-logic-type)
* [Setting up Points results logic](#setting-up-points-results-logic)
  * [Step 1: Assigning points for your answers](#step-1-assigning-points-for-your-answers)
  * [Step 2: Creating results and assigning a points range](#step-2-creating-results-and-assigning-a-points-range)
* [Result outcome types](#choosing-a-result-outcome-type)

***

## Changing the results logic type

You can adjust the results logic on any quiz that has been created with a blank template.&#x20;

**Steps:**

1. From the quiz builder, click **Settings.**
2. Click **Recommendations**.&#x20;
3. Under **Results Logic**, click the drop-down menu for logic options, and click **Points.**&#x20;
4. Click **Save**.

***

## Setting up Points results logic

To set up Points results logic, you need to assign each of your quiz answers a number of points (a numerical value). You also need to assign each quiz result a points range (ex. 5-10 points). Customers accumulate answer points while they answer your quiz and fall into one of your results points ranges at the end of the quiz, which determines their results.

Before you start, it's helpful to understand the result [outcome types](#choosing-a-result-outcome-type) that you can choose for the results page.

### Step 1: Assigning points for your answers

1. From the quiz builder, click the **Quiz** tab.
2. Click the question, then the answer that you want to assign points to.
3. On the right-hand menu, under **Points**, enter a number that this answer is worth.
4. Click **Save**.

### Step 2: Creating results and assigning a points range

1. From the quiz builder, click **Results**.
2. From the left-hand menu, click **Add result**, and give the result a name under **Result name** on the right-hand menu.
3. Click **Outcome**, and from the right-hand menu, select an [outcome type](#choosing-a-result-outcome-type) for this result path.
4. Select the results that you want displayed for this path.
5. On the left-hand menu, click **Points**, then click **Edit** on the right-hand menu.
6. Assign numerical values in the **From** and **To** text fields for the range of points you want this result to cover.
7. Click **Save**.

Repeat the steps for all of your answers and results.<br>

{% embed url="<https://www.youtube.com/watch?v=gi8WOUla1Bo>" %}

***

### Result outcome types <a href="#choosing-a-result-outcome-type" id="choosing-a-result-outcome-type"></a>

For a Result weight logic result, you can choose from several different outcome types. When you set up a new path, you need to set up the outcome type under the **Outcome** section.

* **Product:** Provide product suggestions tailored to your customers' responses.
* **Collection**: Provide a specific collection of products tailored to your customers' responses.
* **Tags:** Choose tag(s) to be assigned to your customer according to their responses.
* **Text:** Write a message to appear on the results page according to your customers' responses.
* **URL redirect**: Based on their responses, the customer will be redirected to [a specific URL](/analytics-and-optimization/analytics-and-tracking/quiz-analytics/url-redirect-analytics).


# Product weight logic

Learn about the Product weight results logic type for quiz results.

The Product weight logic type is based on the weight assigned to each product at the answer level.&#x20;

Products are recommended in the results based on which product accumulated the most weight (numerical value) by the end of the quiz.

Instead of creating answer paths, you directly link questions with products on the question creation page and allocate a specific weight to each product.

## In this section

* [Changing the results logic type](#changing-the-recommendations-logic-type)
* [Setting up Product weight results logic](#setting-up-product-weight-results-logic)

***

## Changing the results logic type <a href="#changing-the-recommendations-logic-type" id="changing-the-recommendations-logic-type"></a>

You can adjust the results logic on any quiz that has been created with a blank template.&#x20;

**Steps:**

1. From the quiz builder, click **Settings.**
2. Click **Recommendations**.
3. Under **Results Logic**, click the drop-down menu for logic options, and click **Single.**
4. In the text box under **Recommended products limit**, enter the maximum number of products that you want to show on the quiz results page.
5. Click **Save**.

***

## Setting up Product weight results logic

To set up the Product weight results logic, you need to recommend products for each answer, and assign weights to them.

**Steps:**

1. From the quiz builder, click on the **Quiz** tab.
2. Click a question, then an answer that you want to set up product weights for.
3. On the right-hand menu, under **Selected products**, click **Select products**.
4. Check all the products that you want to recommend when a customer chooses this answer, then click **Save and close**.
5. Click **Add weight** next to one of the products you selected.
6. In the text box, enter a weight (a numerical value) you want to give the product. You can set the weight for the full product, or for each variant.&#x20;
7. Click **Apply**, then click **Save**.

Repeat steps 2 to 7 for each of your answers that you want to associate product weights for.

The product with the highest weighted score is recommended at the end of the quiz.

{% embed url="<https://www.youtube.com/watch?v=uhJO_dut3bg>" %}


# Result weight logic

Learn about the Result weight logic type for quiz results.

The Result weight logic type recommends products based on their frequency of being chosen as an answer.&#x20;

Instead of opting for answer paths, you directly link answers with results on the question creation page. When an answer is chosen, the logic assigns additional points to that result.

At the end of the quiz, the product with the highest point accumulation is recommended. Each answer can only be associated with a single result.

## In this section

* [Changing the results logic type](#changing-the-results-logic-type)
* [Setting up Result weight logic](#setting-up-result-weight-logic)
  * [Step 1: Setting up a result outcome](#step-1-setting-up-a-result-outcome)
  * [Step 2: Associating answers with results](#step-2-associating-answers-with-results)
  * [Tiebreaker](#tiebreaker)
* [Result outcome types](#choosing-a-result-outcome-type)

***

## Changing the results logic type

You can adjust the results logic on any quiz that has been created with a blank template.&#x20;

**Steps:**

1. From the quiz builder, click **Settings.**
2. Click **Recommendations**.&#x20;
3. Under **Results Logic**, click the drop-down menu for logic options, and click **Result weight.**&#x20;
4. Click **Save**.

***

## Setting up Result weight logic

Before you start, it's helpful to understand the [result outcome types](#choosing-a-result-outcome-type) that you can choose for the results page.

### Step 1: Setting up a result outcome

1. From the quiz builder menu, click the **Results** tab.
2. From the left-hand menu, click **Add result**, and give the result a name under **Result name** on the right-hand menu.
3. Click **Outcome**, and from the right-hand menu, select an [outcome type ](#choosing-a-result-outcome-type)for this result path.
4. Select the results that you want displayed for this path.
5. Click **Save**.

### Step 2: Associating answers with results

1. From the quiz builder menu, click the **Quiz** tab.
2. Click the question, then the answer that you want to edit.
3. On the right-hand menu, under **Result**, click **Select Result**.
4. Click **Select** beside the result that you want this answer to be associated with. If a customer selects this answer, then it will give points to this result.
5. Repeat steps 2-4 for all of your answers.
6. Click **Save**.

### Tiebreaker

At the end of the quiz, if there is a tie where multiple results receive the same number of points, then the recommendation defaults to the first result configured in your quiz.&#x20;

This result is the one at the top of your results list, or with the ID `01` in the **Select result** menu.

{% embed url="<https://www.youtube.com/watch?v=_MyqFqrieAQ>" %}

***

### Result outcome types <a href="#choosing-a-result-outcome-type" id="choosing-a-result-outcome-type"></a>

For a Result weight logic result, you can choose from several different outcome types. When you set up a new path, you need to set up the outcome type under the **Outcome** section.

* **Product:** Provide product suggestions tailored to your customers' responses.
* **Collection**: Provide a specific collection of products tailored to your customers' responses.
* **Tags:** Choose tag(s) to be assigned to your customer according to their responses.
* **Text:** Write a message to appear on the results page according to your customers' responses.
* **URL redirect**: Based on their responses, the customer will be redirected to [a specific URL](/analytics-and-optimization/analytics-and-tracking/quiz-analytics/url-redirect-analytics).


# Combination logic

Learn about the Combination results logic type for quiz results.

The Combination logic type combines both the Basic and Single logic types. The results are shaped by both the individual quiz answers chosen (Single logic), and also by the combination of all of the answers chosen (Basic logic).

## In this section

* [Changing the results logic type](#changing-the-recommendations-logic-type)
* [Setting up Single logic results](#setting-up-basic-logic-results)
* [Setting up Basic logic results](#setting-up-basic-logic-results-1)
  * [Step 1: Setting up a result outcome](#step-1-setting-up-a-result-outcome)
  * [Step 2: Setting up a result path](#step-2-setting-up-a-result-path)
* [AND/OR logic](#and-or-logic)
* [Result outcome types](#choosing-a-result-outcome-type)

***

## Changing the results logic type <a href="#changing-the-recommendations-logic-type" id="changing-the-recommendations-logic-type"></a>

You can adjust the results logic on any quiz that has been created with a blank template.&#x20;

**Steps:**

1. From the quiz builder, click **Settings.**
2. Click **Recommendations**.
3. Under **Results Logic**, click the drop-down menu for logic options, and click **Combination.**
4. Optional: In the text box under **Recommended products limit**, enter the maximum number of products that you want to show on the quiz results page. Leave the field blank if you want to remove the limit.
5. Click **Save**.

***

## Setting up Single logic results <a href="#setting-up-basic-logic-results" id="setting-up-basic-logic-results"></a>

To have product recommendations associated with certain quiz answers, you need to connect products to the answers in your quiz at the answer level.

**Steps:**

1. From the quiz builder menu, click the **Quiz** tab.
2. From the left-hand menu, click the question, then the answer that you want to set up product recommendations for.
3. Under **Selected products**, click **Select products**.
4. Check all of the products that you want to be recommended for this quiz answer.
5. Click **Save and close**, then click **Save**.

Repeat this process to define product recommendations for all of the answers in your quiz that you want to recommend products for.

***

## Setting up Basic logic results <a href="#setting-up-basic-logic-results" id="setting-up-basic-logic-results"></a>

To set up Basic logic results, you need to set up an answer path for each result that you want to create. In other words, the customer needs to select certain answers to each question to get a specific result.

Before you start, it's helpful to understand the [result outcome types](#choosing-a-result-outcome-type) that you can choose for the results page.

### Step 1: Setting up a result outcome <a href="#step-1-setting-up-a-result-outcome" id="step-1-setting-up-a-result-outcome"></a>

1. From the quiz builder menu, click the **Results** tab.
2. From the left-hand menu, click **Add result**, and give the result a name under **Result name** on the right-hand menu.
3. Click **Outcome**, and from the right-hand menu, select an [outcome type](#choosing-a-result-outcome-type) for this result path.
4. Select the results that you want displayed for this path.
5. Click **Save**.

### Step 2: Setting up a result path <a href="#step-2-setting-up-a-result-path" id="step-2-setting-up-a-result-path"></a>

1. From the left-hand menu, click **Path**.
2. From the right-hand menu, under each of your quiz questions, click **Choose an option**, and select the answers to that question that you want to lead to this outcome. You can add more than one.
3. Click **Save**.

You can repeat this process to create as many result outcomes as you want.

{% hint style="info" %}
If you have different results that have similar outcomes or paths, then you can save time by clicking the **Duplicate** button beside a result to duplicate it.
{% endhint %}

### AND/OR logic

If you have your quiz set up so that customers can select more than one answer to a given question, then you might encounter AND/OR logic in the result path setup.

The AND/OR logic field populates when your quiz is set up for multiple answers, and you chose multiple answers for the path.

* **OR logic** means a customer can select **any one** of the answers to reach that result.
* **AND logic** means the customer has to select **all** of the answers to reach that result.

{% embed url="<https://www.youtube.com/watch?v=w6dBFDHK4Wc>" %}

***

### Result outcome types <a href="#choosing-a-result-outcome-type" id="choosing-a-result-outcome-type"></a>

For a Combination logic result, you can choose from several different outcome types. When you set up a new path, you need to set up the outcome type under the **Outcome** section.

* **Product:** Provide product suggestions tailored to your customers' responses.
* **Collection**: Provide a specific collection of products tailored to your customers' responses.
* **Tags:** Choose tag(s) to be assigned to your customer according to their responses.
* **Text:** Write a message to appear on the results page according to your customers' responses.
* **URL redirect**: Based on their responses, the customer will be redirected to [a specific URL](/analytics-and-optimization/analytics-and-tracking/quiz-analytics/url-redirect-analytics).


# Logic jumps

Learn how to create logic jumps to direct customers to specific questions based on their answers.

Logic jumps involve directing the customer to a specific question based on their previous answer. If you set up logic jumps, then you cause a customer's quiz experience to be shaped by their quiz responses, rather than by following the predetermined order of the quiz questions or the other logic types.

## In this section

* [Enabling logic jumps](#enabling-logic-jumps)
* [Logic jumps flow map](#logic-jumps-flow-map)
  * [Editing logic jumps in the flow map](#editing-logic-jumps-in-the-flow-map)
* [Adding internal labels to question](#adding-internal-labels-to-questions)

***

## Enabling logic jumps

Before you can set up logic jumps in your quiz, you need to enable the feature.

**Steps:**

1. From the quiz builder menu, click **Settings**.
2. From the **Quiz** page, navigate to **Logic jumps**, and click **Enable**.
3. Click **Enable** again.

Logic jumps are enabled for your quiz and you can proceed to setting up a logic chain.

***

## Logic jumps flow map

After you've enabled logic jumps, you can access the **Logic jumps flow map**, which allows you to visualize and edit answer paths, making it easy to see how answers connect and update the flow directly.&#x20;

Click any question to view its connected answer paths. If answers lead to different questions through logic jumps, colored arrows show where each answer leads.

<figure><img src="/files/A1ouFTHyWNCyNjRJvl1T" alt="" width="563"><figcaption></figcaption></figure>

### Editing logic jumps in the flow map

**Steps:**

1. From the quiz builder's **Quiz** tab, click a question, then click **Edit flow map**. You can also open the flow map anytime from the left-hand menu by clicking **Logic jumps flow map**.
2. From the flow map, find the question with the answer path you want to update.
3. Hover over an answer, and click **Edit lead**.
4. Under **Leads to**, select the question you want that answer to connect to.
5. Repeat for any other answers you want to update.
6. Click **Save**.

Review your quiz flow to make sure each answer leads to the intended question. If no logic jump is configured for an answer, the quiz will use the default fallback result.

{% hint style="info" %}
**Note:** \
\
If you’ve enabled multiple answers or the option to skip a question, you won’t be able to assign logic jumps to individual answers. Instead, set the **Leads to** value for the entire question.
{% endhint %}

***

## Adding internal labels to questions

You can assign an internal label to each question to assist you in tasks like determining logic paths.&#x20;

These labels are only visible internally, and not to customers.

**Steps:**

1. From the quiz builder, click on a question.
2. On the right-hand menu, navigate to the **Settings** section.
3. Click the text box under **Internal label** and enter any label for this question.
4. Click **Save**.


# Fallback results

Learn about fallback results and how to set the outcome type for quiz paths without manual results.

Fallback results ensure every quiz path returns an outcome, even if you haven't manually defined results for that path. By default, fallback results are AI generated, but you can change the outcome type at any time if you want to set a manual fallback type.

[Manual logic result](/building-a-quiz/results/results-logic) paths always take priority over fallback results.

## AI fallback

AI fallback is enabled on new quizzes by default. Quiz Kit syncs your store's products, metafields, and pages to generate recommendations. This means you don't need to manually select products for AI to consider. It draws from your full catalog to find the best matches for each quiz taker.

{% hint style="info" %}
**Note**

For very large stores, Quiz Kit may not be able to sync your entire catalog, which means AI fallback may not be available. This affects approximately 1% of stores.
{% endhint %}

***

## Set your fallback outcome type

By default, your fallback outcome type is set to AI generated. You can change this to another outcome type at any time.

**Steps:**

1. From the quiz builder, click **Results** in the left-hand menu.
2. Go to **Fallback results** > **Outcome**.
3. In the right-hand menu, under **Outcome** > **Type**, click the drop-down menu and select an [outcome type](/building-a-quiz/results/outcome-types).
4. Click **Save**.

Learn more about [Outcome types](/building-a-quiz/results/outcome-types).


# Outcome types

Learn about the different outcome types for some results logic.

For some results logic, you can choose from several different outcome types. When you set up a new path, you need to set up the outcome type under the **Outcome** section.

* **AI generated:** Quiz Kit uses AI and your product selection to map any paths without manual results to an AI-generated outcome, based on your store data.
* **Product:** Provide product suggestions tailored to your customers' responses.
* **Collection**: Provide a specific collection of products tailored to your customers' responses.
* **Tags:** Choose tag(s) to be assigned to your customer according to their responses.
* **Text:** Write a message to appear on the results page according to your customers' responses.
* **URL redirect**: Based on their responses, the customer will be redirected to [a specific URL](https://support.quizkitapp.com/analytics-and-optimization/analytics-and-tracking/quiz-analytics/url-redirect-analytics).


# Results template

Learn how to create unique layouts for your quiz results page with custom content in the template section.

You can create custom content sections or choose from content block combination layouts.

{% hint style="info" %}
**Note**

In each custom content section, you can apply a maximum of 2 content blocks.
{% endhint %}

## In this section:

* [Content blocks](#content-blocks)
  * [Adding a content block](#adding-a-content-block)
  * [Editing content blocks](#editing-content-blocks)
  * [Styling your content](#styling-your-content)
  * [Previewing and publishing](#previewing-and-publishing)
  * [Best practices](#best-practices)
  * [Troubleshooting](#troubleshooting)

***

{% embed url="<https://www.youtube.com/watch?v=sI2gqAEJxaM>" %}

## Content blocks

Content blocks are the building blocks of your custom results page. There are several types of content that you can add:

* **Text**: For paragraphs, headings, or any text-based content.
* **Image**: To add photos, graphics, or illustrations.
* **Video**: Embed videos to explain results or provide additional information.
* **Product Recommendation**: Showcase products or services relevant to the quiz outcome.
* **Collection**: Showcase products or services you'd like to highlight in addition to the quiz-recommended results.
* **Newsletter:** Add a newsletter sign-up form to grow your customer newsletter base.
* **Articles:** Display engaging articles on various topics: Showcase your products, share expert insights, or provide interesting information to your customers.
* **FAQ**: A section dedicated to the frequently asked questions about this result.
* **Custom content**: A combination of other content types that you can mix and match, like text and video.
* **HTML & CSS:** Add your own custom code for even more customization.

***

### Adding a content block

1. From the quiz builder, click **Results**.
2. Under Template, click **+ Add section**.&#x20;
3. Choose the type of content block that you want to add.
4. Drag and drop the block to your desired location on the page.
5. Click **Save**.

### Editing content blocks

1. From the **Template** section, click a content block.
2. Use the editing panel on the right to modify the content:
   * For text: Edit directly in the block or use the rich text editor.
   * For images/videos: Upload new media or provide a URL.
   * For CTAs: Set the button text and link.
3. Click **Save**.

### Styling your content

1. From the **Template** section, click a content block.
2. Use the **Style** tab in the editing panel to customize:
   * Font styles (for text blocks)
   * Colors
   * Margins and padding
   * Animations or transitions
3. Click **Save**.

{% hint style="info" %}
**Note:**&#x20;

Certain style settings only apply to specific content block types.&#x20;
{% endhint %}

### Previewing and publishing

1. From the Results page, click **Preview.**
2. Use the device toggle to check appearance on desktop, tablet, and mobile.
3. When you're ready, click **Publish** to make your changes live.

### Best practices

* Keep your content concise and relevant to the quiz results.
* Use a consistent style throughout your results page.
* Ensure your content is accessible – use alt text for images and captions for videos.
* Test your results page thoroughly especially if you're using jump logic.

### Troubleshooting

* **Changes not appearing**: Make sure you've clicked **Publish** after making edits.
* **Conditional content not working**: Double-check your display conditions and test with different quiz outcomes.
* **Styling issues**: Ensure your custom styles don't conflict with the base theme. Use the preview function to check across devices.


# Integrations

Set up Quiz Kit to integrate with the apps and features that are important to your business.

You can set Quiz Kit up to integrate with many of the marketing apps and native Shopify features that you use for your store. \
\
Shopify features that can be integrated with Quiz Kit are the following:

* [Shopify Subscriptions](/building-a-quiz/integrations/shopify/shopify-subscriptions)
* [Shopify Flow](/building-a-quiz/integrations/shopify/shopify-flow)
* [Shopify Customers List](/building-a-quiz/integrations/shopify/shopify-customers-list)
* [Shopify Checkout UI](/building-a-quiz/integrations/shopify/shopify-checkout-ui)
* [Shopify Markets](/building-a-quiz/integrations/shopify/shopify-markets)

***

Apps that can be integrated with Quiz Kit are the following:

**Marketing and CRM**:

* [ActiveCampaign](/building-a-quiz/integrations/email-and-sms/activecampaign)
* [Additional marketing data](/building-a-quiz/integrations/analytics-and-tracking/additional-marketing-data)
* [Attentive](/building-a-quiz/integrations/email-and-sms/attentive)
* [Facebook Pixel](/building-a-quiz/integrations/analytics-and-tracking/meta-pixel-facebook-pixel)
* [Google Analytics](/building-a-quiz/integrations/analytics-and-tracking/google-analytics)
* [Klaviyo](/building-a-quiz/integrations/email-and-sms/klaviyo)
* [Mailchimp](/building-a-quiz/integrations/email-and-sms/mailchimp)
* [Omnisend](/building-a-quiz/integrations/email-and-sms/omnisend)
* [Sendlane](/building-a-quiz/integrations/email-and-sms/sendlane)
* [Yotpo](/building-a-quiz/integrations/marketing-automation/yotpo)
* [Zapier](/building-a-quiz/integrations/marketing-automation/zapier)

**Subscriptions**:<br>

* [Recharge](/building-a-quiz/integrations/subscriptions/recharge)
* [Shopify Subscriptions](/building-a-quiz/integrations/shopify/shopify-subscriptions)
* [Skio](/building-a-quiz/integrations/subscriptions/skio)
* [Smartrr](/building-a-quiz/integrations/subscriptions/smartrr)

**Custom and page builders**:<br>

* [PageFly](/building-a-quiz/integrations/marketing-automation/pagefly)<br>


# Shopify

Learn about the different Shopify features that integrate with Quiz Kit.

## In this section:

* [Shopify Subscriptions](/building-a-quiz/integrations/shopify/shopify-subscriptions)
* [Shopify Flow](/building-a-quiz/integrations/shopify/shopify-flow)
* [Shopify Customers List](/building-a-quiz/integrations/shopify/shopify-customers-list)
* [Shopify Checkout UI](/building-a-quiz/integrations/shopify/shopify-checkout-ui)
* [Shopify Markets](/building-a-quiz/integrations/shopify/shopify-markets)


# Shopify Subscriptions

Learn about the different subscription apps that integrate with Quiz Kit.

Quiz Kit allows you to connect with any subscription app that uses native Shopify checkout by displaying subscription products on your quiz results page.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

### Things to note:

* You can connect ANY subscription app that uses the Shopify checkout.
* If subscriptions are being pulled into the quiz with incorrect formatting, then you can fix it by going to **Recommendations** > Check **Use plan name in a frequency select box.**
* You can also pre-define subscription plans in the **Answers** section of the quiz.

### Learn how to connect our most popular subscription apps:

{% content-ref url="/pages/CWOGqKMlu8dKnQm60bg5" %}
[Recharge](/building-a-quiz/integrations/subscriptions/recharge)
{% endcontent-ref %}

{% content-ref url="/pages/dgYhHmNxNq5qpM1aAgk2" %}
[Skio](/building-a-quiz/integrations/subscriptions/skio)
{% endcontent-ref %}

{% content-ref url="/pages/OcSFdXqVDnJREBCuCJUQ" %}
[Smartrr](/building-a-quiz/integrations/subscriptions/smartrr)
{% endcontent-ref %}


# Shopify Flow

Learn how to use Shopify Flow to automate Quiz Kit events.

Shopify Flow allows you to build custom automations and create unique workflows without needing to code.

{% hint style="info" %}
**Note:**&#x20;

Shopify Flow is available to customers on the **Shopify**, **Advanced**, or **Shopify Plus** plans.
{% endhint %}

***

## Connecting Shopify Flow to Quiz Kit

Before you begin, ensure that the Shopify Flow app is installed in your store.

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Shopify** tab, go to **Shopify Flow.**
3. Click **Enable**.

***

## Creating automated quiz actions

You can collect information about quiz starts, completions, and abandonment and have them delivered to your inbox.&#x20;

**Steps:**

1. From the Shopify Flow app, click **Create workflow**.
2. Click **Select a trigger**.
3. Click Quiz Kit and select one of the following triggers:
   1. Quiz abandonment
   2. Quiz started
   3. Quiz completed
4. Select the action **Send internal email** and add quiz properties (Trigger variables) that are passed to the email:

<figure><img src="/files/PPjyWpgWrJVpYzAT5rGZ" alt=""><figcaption></figcaption></figure>


# Shopify Customers List

Learn how Quiz Kit can create customers from each quiz submission.

You can set up customer data captured from quizzes to be stored in your Shopify Customers lists.

***

## Connecting Shopify Customers List to Quiz Kit

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Shopify** tab, go to **Shopify Customers List.**
3. Click **Enable**.

After you've enabled the integration, all customers who have completed the quiz and left their email address are added as customers in the Shopify **Customers** section, with the tag `Quiz Kit app subscriber`.&#x20;

You can learn more about how to [collect customer contact information](/building-a-quiz/collecting-customer-data).


# Shopify Checkout UI

Checkout extensibility opens new ways to customize checkouts on Shopify.

{% hint style="info" %}
**Note:**

This feature is available only for **Shopify Plus** stores. If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

You can show quiz results or other products on the checkout page with Shopify's Checkout UI feature.

***

## Connecting Shopify Checkout UI to Quiz Kit

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Shopify** tab, go to **Shopify Checkout UI.**
3. Click **Settings**.
4. Click **Activate**.
5. Click **Save**.

***

## Customizing the Checkout UI

You can select which products will be shown to customers at the checkout.&#x20;

Quiz Kit has three options:

1. **Result products** - If the customer completes the quiz, then the customer's recommendation is shown on the checkout page, up to a maximum of 4 products. The user should be logged in and leave the same email while completing the quiz.
2. **Fallback products** - Show specific products for customers on the checkout page, even if they haven't completed the quiz. You can select up to 4 products.
3. **Personal smart recommendations** - Show smart recommendations on the checkout page. To do this, you need to activate [personalization](/advanced-settings/personalizing-your-quiz), enable [smart recommendations](/advanced-settings/personalizing-your-quiz), and add relevant sections to your online store theme.&#x20;

Checkout UI elements automatically inherit the store brand settings.

***

## Adding the extension to checkout page

**Steps:**

1. From the Shopify admin, go to **Settings** > **Checkout.**
2. Under **Configurations**, click **Customize**.
3. From the left-hand menu, click **Apps**.
4. From available app extensions select Quiz Kit upsell products.

Upsell product section can be moved to any available location on the page.

Recommended products are shown when the customer completes the quiz with their email address and are logged into their customer account with the same email address.


# Shopify Markets

Learn how to use Shopify Markets with Quiz Kit.

You can use Shopify Markets with Quiz Kit to reach a wider audience.

***

## Connecting Shopify Markets to Quiz Kit

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Shopify** tab, go to **Shopify Markets.**
3. Click **Enable**.
4. From the Shopify Admin, go to **Settings**.
5. Click **Markets**. Here, you can customize your Markets settings for cross-border selling.&#x20;

Refer to the Shopify Help Center for additional information on [Shopify Markets](https://help.shopify.com/en/manual/markets).


# Email and SMS

Learn about the different Email and SMS apps and tools that integrate with Quiz Kit.

## In this section:

* [ActiveCampaign](/building-a-quiz/integrations/email-and-sms/activecampaign)
* [Additional marketing data](/building-a-quiz/integrations/analytics-and-tracking/additional-marketing-data)
* [Attentive](/building-a-quiz/integrations/email-and-sms/attentive)
* [Klaviyo](/building-a-quiz/integrations/email-and-sms/klaviyo)
* [Mailchimp](/building-a-quiz/integrations/email-and-sms/mailchimp)
* [Omnisend](/building-a-quiz/integrations/email-and-sms/omnisend)
* [Sendlane](/building-a-quiz/integrations/email-and-sms/sendlane)


# Klaviyo

Integrate Klaviyo email marketing with Quiz Kit to import quiz submissions to your Klaviyo lists.

Integrating [Klaviyo](https://apps.shopify.com/klaviyo-email-marketing) with the Quiz Kit app allows you to automatically add new customers who took your quizzes to your [Klaviyo lists](https://help.klaviyo.com/hc/en-us/articles/115005078967#h_01HB678Y7ZYS5JDNGSYJEEPPK9).&#x20;

Quiz responses are saved as custom properties for each customer, enabling targeting marketing campaigns.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Basic** plan or higher.
{% endhint %}

## In this section:

* [Connecting Klaviyo to Quiz Kit](#connecting-klaviyo-to-quiz-kit)
* [Adding email capture to your quiz](#adding-email-capture-to-your-quiz)
* [Passing quiz submissions to your Klaviyo list](#passing-quiz-submissions-to-your-klaviyo-list)
* [Adding form questions](#adding-form-questions)
* [Enabling email capture on older active quizzes](#enabling-email-capture-on-older-active-quizzes)
* [Sending quiz results to customers](#sending-quiz-results-to-customers)

***

## Connecting Klaviyo to Quiz Kit

Once you've created a Klaviyo account, you can connect it to Quiz Kit.&#x20;

**Steps:**

1. From the Quiz Kit app menu, click **Integrations**.
2. Ensure the **Email marketing** tab is selected.
3. Under the Klavyio app, click **Connect**.
4. Click **Enable OAuth authentication**, then click **Continue.**
5. Review the information, then click **Allow**.

A confirmation message displays to confirm that you've connected Quiz Kit to Klaviyo.

***

## Adding email capture to your quiz

If you want to capture a customer's email from a quiz and pass it to Klaviyo, then you need to add a page in your quiz to allow them to input their email address.

**Steps:**

1. From the Quiz Kit app dashboard, click **Customize** on the quiz that you want to set up Klaviyo submissions for.
2. From the default Quiz menu, click **Add page**, then click **Email capture** from the list. The default email capture template displays.&#x20;
3. **Optional:** You can customize the template using the **Content** and **Fields** sections according to your preference.&#x20;
4. Click **Save**.

{% hint style="info" %}
**Note:**&#x20;

For GDPR reasons you can make this question optional to your customer by checking **Enable ability to skip this question**. You can also check **Enable fake emails validation** to minimize the possibility of fake email submission.
{% endhint %}

***

## Passing quiz submissions to your Klaviyo list

When you've integrated Klaviyo with your store, you can set up new quiz submissions to be sent to your Klaviyo list.

{% hint style="info" %}
**Note**

After setting up the Klaviyo connection, you need to take the quiz once yourself, up to the email submission question, so that future quiz submissions are sent to Klaviyo.
{% endhint %}

**Steps:**

1. From the Quiz Kit app, click **My Quizzes**, then click **Customize** on the quiz that you want to set up Klaviyo submissions for.
2. Click the gear wheel to open the **Settings** menu, then click **Integrations**.
3. In the **Custom properties** section, you can check any properties that you want to collect from quiz submissions to include them.
4. In the **Klaviyo** section, from the **Available lists** drop-down menu, select one of the list options.
5. Click **Save**.
6. Once you've set up your list, you need to complete your quiz once, up to the point of submitting a valid email address, in order to trigger the Klaviyo flow.

***

## Adding form questions

You can use form fields to gather additional information from your customers, like phone numbers and dates (ex. birthdays).

**Steps:**

1. From the Quiz Kit app, click **Customize** on the quiz that you want to set up Klaviyo submissions for.
2. From the default Quiz menu, click **Add page**, then click **Form field** from the list.
3. Click **Fields** > **Field 1**, then click under **Type** to select one of the following for your form response section:&#x20;
   1. **Text**: a short text field
   2. **Text Area**: a longer text field
   3. **Date**: a date picker
   4. **Number**: a number field for phone numbers and other number-related responses
4. **Optional**: Customize any other sections that you want like the field name or placeholder text.
5. Click **Save**.

{% hint style="info" %}
**Note**:&#x20;

To pass the customer's first name to Klaviyo, add one more field and insert type `first_name` in the **Marketing property name** field.
{% endhint %}

***

## Enabling email capture on older active quizzes

If you have older quizzes that have been active for a longer period of time, you might need to enable email capture by an alternative method.

**Steps:**

1. From the Quiz Kit app, click **Customize** on the quiz that you want to set up Klaviyo submissions for.
2. Click the gear wheel to open the **Settings** menu, then click **Email/SMS.**
3. Check **Show email/phone capture form before results.**
4. Click **Save.**

When you’ve completed the steps, all emails entered during quiz completion are sent to the chosen Klaviyo list, and all questions and answers are set as customer custom properties to your selected list.

You can create segments based on customer answers.

***

## Sending quiz results to customers&#x20;

You can set up an email trigger within Klaviyo so that customers are automatically sent their email results when they complete your quiz. Learn more about [sending quiz results to customers via Klaviyo](/building-a-quiz/collecting-customer-data/sending-quiz-results-to-customers-via-klaviyo).


# Mailchimp

Learn how to connect the Mailchimp integration, and set it up in your quiz.

Quiz Kit allows you to integrate with Mailchimp and send quiz submissions to specific Mailchimp lists.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Basic** plan or higher.
{% endhint %}

## In this section

* [Connecting Quiz Kit to Mailchimp](#connecting-quiz-kit-to-mailchimp)
* [Setting up Mailchimp to receive quiz submissions](#setting-up-mailchimp-to-receive-quiz-submissions)
* [Setting up merge tags in Mailchimp](#setting-up-merge-tags-in-mailchim)

***

## Connecting Quiz Kit to Mailchimp

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. From the **Email marketing** tab, go to **Mailchimp** and click **Connect**.
3. Insert your Mailchimp **Private** **API key**.
4. Click **Save**.&#x20;

***

## Setting up Mailchimp to receive quiz submissions

**Steps:**

1. From the quiz builder, click **Settings**.
2. Click **Integrations**.
3. From the list of integrations, go to **Mailchimp**, and click the drop-down arrow beside it.
4. Under **Available lists**, select the Mailchimp list that you want to connect, and click **Save**.&#x20;

***

## Setting up merge tags in Mailchimp

Before Quiz Kit can send questions, answers, and customer data to Mailchimp, you need to set up merge tags in Mailchimp.&#x20;

Mailchimp merge tags are placeholders that dynamically insert personalized content (like quiz answers) into emails, based on data stored in your audience fields. Learn more about [setting up your merge tags in Mailchimp](https://support.clickfunnels.com/support/solutions/articles/150000152850).

### Examples of merge tags

You can find an example of how to set up your Mailchimp merge tags by clicking **Important note** from the Mailchimp integration section that you set up [in the previous section](#setting-up-mailchimp-to-receive-quiz-submissions).

For example, if you have a question like `What is your hair color?` in your quiz, you would use the following:

* The **Label** is your question. You can just copy and paste the actual quiz question for this field. For example, `What is your hair color?`
* The **Tag** is the merge tag, and is machine-readable by Mailchimp, so keep it simple and descriptive, but without any spaces. For example, `HAIRCOLOR`.
* The **Type** is `text`.

The following is an example of what you see in the **Important note**, and can be used to help you create your own tags in Mailchimp.

<figure><img src="/files/AFdSE23PaVNaSuWH96HF" alt=""><figcaption></figcaption></figure>

After you've completed these steps, all future quiz completions are sent to the chosen Mailchimp list.


# Omnisend

Learn how to connect the Omnisend integration, and set it up in your quiz.

Quiz Kit allows you to add new customers to your Omnisend account.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Basic** plan or higher.
{% endhint %}

## Connecting Quiz Kit to Omnisend

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Email marketing** tab, go to **Omnisend** and click **Connect**.
3. Insert your Omnisend **Private** **API key**.
4. Click **Save**.&#x20;

In order for the email and contact information to be passed to Omnisend, make sure you're [collecting customer data](/building-a-quiz/collecting-customer-data) on your quiz.&#x20;

If you're using a form field question, use the **Marketing property name** field to pass the correct information, such as entering `firstName` if you're collecting the customer's first name.


# Attentive

Learn how to connect to the Attentive integration and set it up in your quiz.

Quiz Kit allows you to add new customers to your Attentive account.&#x20;

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Basic** plan or higher.
{% endhint %}

Events, questions, and answers that the customer chooses while going through your quiz are attached to that customer as custom properties.

In this section

* [Connecting to Attentive](#connecting-to-attentive)
* [Get an API sign-up source from Attentive](#get-an-api-sign-up-source-id-from-attentive)
* [Setting up Attentive in your quiz](#setting-up-attentive-in-your-quiz)

***

## Connecting to Attentive

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Email marketing** tab, go to **Attentive** and click **Connect**.
3. Insert your Attentive **Private API key** in the appropriate field.
4. Click **Save**.&#x20;

The video below details how to get the private API key:

{% embed url="<https://www.loom.com/share/9d47c668ba35484b92ec48839fe9f0e4>" %}

***

## Get an API sign-up source ID from Attentive  &#x20;

You need to have Attentive create an API sign-up method to move to the next step.&#x20;

Contact the white glove team `whiteglove@attentivemobile.com` or your client strategy manager at Attentive to request this ID be created for you.

***

## Setting up Attentive in your quiz

{% hint style="info" %}
**Note:**

Before this step, you need to have a Sign-up source ID, created for you by Attentive support, detailed in the last step.
{% endhint %}

**Steps:**

1. From the quiz builder, click **Settings**.
2. Click **Integrations**.
3. From the list of integrations, go to **Attentive**, and click the drop-down arrow beside it.
4. Under **Sign-up source ID**, add the ID Attentive gave you.
5. Click **Save**.&#x20;

Once you've clicked save, all quiz completions (if contact information was entered) are sent to your Attentive account.&#x20;

All questions and answers are set as customer custom properties. You can create segments based on question's answers.

You can [collect customers' emails](/building-a-quiz/collecting-customer-data) or phone numbers in a separate question, and insert the email/phone value into the [marketing property name](/building-a-quiz/integrations/analytics-and-tracking/additional-marketing-data#change-the-marketing-property-name) field.&#x20;


# ActiveCampaign

Learn how to connect the ActiveCampaign integration, and set it up in your quiz.

Quiz Kit allows you to connect new customers to your chosen ActiveCampaign list.&#x20;

The questions and answers that the customer chooses while going through your quiz are attached to that customer's profile as custom properties.

## Connecting to ActiveCampaign

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Email marketing** tab, go to **ActiveCampaign** and click **Connect**.
3. Insert your ActiveCampaign **API key**, **API URL**, **Event key**, and **Account ID** in the appropriate fields.
4. Click **Save**.&#x20;

***

## Setting up ActiveCampaign in your quiz

**Steps:**

1. From the quiz builder, click **Settings**.
2. Click **Integrations**.
3. From the list of integrations, go to **ActiveCampaign**, and click the drop-down arrow beside it.
4. Under **Available lists**, select the ActiveCampaign list that you want to connect, and click **Save**.&#x20;

All quiz completions are now sent to the chosen ActiveCampaign list.

All questions and answers will be set as customer custom properties, and then you can create segments based on question's answers.


# Sendlane

Learn how to integrate Sendlane email marketing with the Quiz Kit app.

You can collect customers' data from quizzes using the Sendlane integration.

The questions and answers that the customer chooses during the quiz are attached to that customer's profile as custom properties.

{% hint style="info" %}
**Note:**

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

***

## Connecting Sendlane to Quiz Kit <a href="#connecting-sendlane-to-quiz-kit" id="connecting-sendlane-to-quiz-kit"></a>

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Email marketing** tab, go to **Sendlane** and click **Connect**.
3. Insert your Sendlane **Private** **API key**.
4. Click **Save**.

{% hint style="info" %}
**Note:**

You need a private API token from Sendlane to integrate with Quiz Kit. You can get it from the Sendlane dashboard > **API** > **+ API Token**.
{% endhint %}

<figure><img src="/files/QNepZyVAgJ0mKONj5usj" alt=""><figcaption></figcaption></figure>

***

## Setting up Sendlane to receive quiz submissions <a href="#setting-up-sendlane-to-receive-quiz-submissions" id="setting-up-sendlane-to-receive-quiz-submissions"></a>

**Steps:**

1. From the quiz builder, click **Settings**.
2. Click **Integrations**.
3. From the list of integrations, go to **Sendlane**, and click the drop-down arrow beside it.
4. Under **Available lists**, select the Sendlane list that you want to connect, and click **Save**.

All quiz completions are now sent to the chosen Sendlane list.

***

## Sending customer contact info to Sendlane using questions <a href="#how-to-pass-email-or-first-name-to-klaviyo-using-questions-instead-of-email-capture" id="how-to-pass-email-or-first-name-to-klaviyo-using-questions-instead-of-email-capture"></a>

You can send customer data to Sendlane by ensuring you are capturing customer data using either the **Email capture** or **Form field** question types. Learn more about [collecting customer data](/building-a-quiz/collecting-customer-data) to set up this type of collection question.


# Subscriptions

Learn about the different subscription apps that integrate with Quiz Kit.

Quiz Kit allows you to connect with any subscription app that uses native Shopify checkout by displaying subscription products on your quiz results page.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

### Things to note:

* You can connect ANY subscription app that uses the Shopify checkout.
* If subscriptions are being pulled into the quiz with incorrect formatting, then you can fix it by going to **Recommendations** > Check **Use plan name in a frequency select box.**
* You can also pre-define subscription plans in the **Answers** section of the quiz.

#### Learn how to connect our most popular subscription apps below.

## In this section:

* [Recharge](/building-a-quiz/integrations/subscriptions/recharge)
* [Shopify Subscriptions](/building-a-quiz/integrations/shopify/shopify-subscriptions)
* [Skio](/building-a-quiz/integrations/subscriptions/skio)
* [Smartrr](/building-a-quiz/integrations/subscriptions/smartrr)


# Recharge

Learn how to integrate Recharge with Quiz Kit for Shopify Subscriptions.

Recharge is a subscription management tool that helps retain customers and grow your subscription-based business. Quiz Kit natively integrates with Recharge to display subscription products on your quiz results page.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

***

## Connecting Recharge with Quiz Kit for Shopify Subscriptions

### Enable Shopify Subscriptions

When Shopify Subscriptions is enabled, Quiz Kit can use subscription products from Recharge.&#x20;

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Shopify** tab, go to **Shopify Subscriptions.**
3. Click **Enable**.

If the button under **Shopify Subscriptions** says **Disable**, then the feature is already enabled.

***

## Choosing Recharge Subscription products

{% hint style="info" %}
**Note:**

Ensure you have already configured some products in the Recharge app. These products become available as Quiz Kit recommendations. Recharge has detailed instructions on [How to Add Products](https://support.getrecharge.com/hc/en-us/articles/360052425893-Setting-up-a-product-subscription).&#x20;
{% endhint %}

**Steps:**&#x20;

1. From the Quiz Kit dashboard, click **My Quizzes.**
2. Click **Customize** beside the quiz that you want to edit results for.
3. From the left-hand menu, click **Results.**
4. Click **Edit products** and select the Recharge products that you want to recommend.

&#x20;Results are displayed on your quiz's results page, offering customers subscription options.

For Fallback results, do the following:

1. Under **Fallback result,** click **Outcome.**
2. Under **Type**, choose **Products.**
3. Click **Select products** and choose the Recharge products.

***

## Viewing subscription results

Subscription options are only visible on the published version of your quiz, not in preview mode.

The quiz preview shows you the results and layout.&#x20;

To view the subscription options on the results page, do the following:

1. From the quiz builder, on the left-hand menu, click **Publish**.
2. Click **Theme.**
3. Ensure the quiz is published and not in draft mode. Click the toggle to publish if it's a draft.
4. Under **Add to page**, click **Preview page**.

During preview, the quiz is loaded in your published theme. Here, you can view the quiz and results with the subscription option on the results page.


# Smartrr

Learn how to integrate Smartrr with Quiz Kit for Shopify Subscriptions

Smartrr is a subscription management tool that helps retain customers and grow your subscription-based business. Quiz Kit integrates with Recharge to display subscription products on your quiz results page.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

## Connecting Smartrr with Quiz Kit for Shopify Subscriptions <a href="#connecting-smartrr-with-quiz-kit-for-shopify-subscriptions" id="connecting-smartrr-with-quiz-kit-for-shopify-subscriptions"></a>

### Enable Shopify Subscriptions <a href="#enable-shopify-subscriptions" id="enable-shopify-subscriptions"></a>

When Shopify Subscriptions is enabled, Quiz Kit can use subscription products from Smartrr.

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Shopify** tab, go to **Shopify Subscriptions.**
3. Click **Enable**.

If the button under **Shopify Subscriptions** says **Disable**, then the feature is already enabled.

***

## Choosing Smartrr Subscription products

{% hint style="info" %}
**Note:**

Ensure you have already configured some products in the Smartrr app. These products become available as Quiz Kit recommendations. Smartrr has detailed instructions on [How to Configure Subscription Programs](https://help.smartrr.com/docs/support/subscription-setup/how-do-i-set-up-subscription-programs).
{% endhint %}

**Steps:**

1. From the Quiz Kit dashboard, click **My Quizzes.**
2. Click **Customize** beside the quiz that you want to edit results for.
3. From the left-hand menu, click **Results.**
4. Click **Edit products** and select the Smartrr products that you want to recommend.

These products are displayed on your quiz's results page, offering customers subscription options.

For Fallback results, do the following:

1. Under **Fallback result,** click **Outcome.**
2. Under **Type**, choose **Products.**
3. Click **Select products** and choose the Smartrr products.

***

## Viewing subscription results <a href="#viewing-subscription-results" id="viewing-subscription-results"></a>

Subscription options are only visible on the published version of your quiz, not in preview mode.

The quiz preview shows you the results and layout.

To view the subscription options on the results page:

1. From the quiz builder, on the left-hand menu, click **Publish**.
2. Click **Theme.**
3. Ensure the quiz is published and not in draft mode. Click the toggle to publish if it's a draft.
4. Under **Add to page**, click **Preview page**.

During preview, the quiz is loaded in your published theme. Here, you can view the quiz and results with the subscription option on the results page.


# Skio

Learn how to integrate Skio with Quiz Kit for Shopify Subscriptions.

Quiz Kit integrates with Skio, allowing you to display subscription products directly on your quiz results page.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

***

## Connecting Skio with Quiz Kit for Shopify Subscriptions <a href="#connecting-skio-with-quiz-kit-for-shopify-subscriptions" id="connecting-skio-with-quiz-kit-for-shopify-subscriptions"></a>

### Enable Shopify Subscriptions <a href="#enable-shopify-subscriptions" id="enable-shopify-subscriptions"></a>

When Shopify Subscriptions is enabled, Quiz Kit can use subscription products from Skio.

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Shopify** tab, go to **Shopify Subscriptions.**
3. Click **Enable**.

If the button under **Shopify Subscriptions** says **Disable**, then the feature is already enabled.

***

## Choosing Skio Subscription products <a href="#choosing-skio-subscription-products" id="choosing-skio-subscription-products"></a>

{% hint style="info" %}
**Note:**

Ensure you have already configured some products in the Skio app. These products become available as Quiz Kit recommendations. Skio has detailed instructions on [How to Add Products](https://help.skio.com/hc/en-us/articles/16802518612507-Adding-Products).
{% endhint %}

**Steps:**

1. From the Quiz Kit dashboard, click **My Quizzes.**
2. Click **Customize** beside the quiz you want to edit results for.
3. From the left-hand menu, click **Results.**
4. Click **Edit products** and select the Skio products that you want to recommend.

These products are displayed on your quiz's results page, offering customers subscription options.

For Fallback results, do the following:

1. Under **Fallback result,** click **Outcome.**
2. Under **Type**, choose **Products.**
3. Click **Select products** and choose the Skio products.

***

## Viewing subscription results <a href="#viewing-subscription-results" id="viewing-subscription-results"></a>

Subscription options are only visible on the published version of your quiz, not in preview mode.

The quiz preview shows you the results and layout.

To view the subscription options on the results page:

1. From the quiz builder, on the left-hand menu, click **Publish**.
2. Click **Theme.**
3. Ensure the quiz is published and not in draft mode. Click the toggle to publish if it's a draft.
4. Under **Add to page**, click **Preview page**.

During preview, the quiz is loaded in your published theme. Here, you can view the quiz and results with the subscription option on the results page.


# Marketing automation

Learn about the different marketing automation apps that integrate with Quiz Kit.

## In this section:

* [Yotpo](/building-a-quiz/integrations/marketing-automation/yotpo)
* [PageFly](/building-a-quiz/integrations/marketing-automation/pagefly)
* [Zapier](/building-a-quiz/integrations/marketing-automation/zapier)


# Yotpo

Learn how to integrate Yotpo Email Marketing & SMS with Quiz Kit to enhance customer engagement and boosts conversions.

{% hint style="warning" %}
**Note:**

Yotpo is sunsetting its native Email and SMS tools in December 2025. As a result, the Quiz Kit – Yotpo integration will also end. After Yotpo’s email services are sunset, you won’t be able to create customer lists or flows using quiz responses in Yotpo.\
\
You can use [Klaviyo](/building-a-quiz/integrations/email-and-sms/klaviyo) for email marketing tools that integrate with Quiz Kit.
{% endhint %}

Yotpo’s tools enable personalized, timely messages, while Quiz Kit gathers valuable customer insights through interactive quizzes. This combination allows for targeted marketing campaigns based on quiz responses

## Connecting Yotpo to Quiz Kit <a href="#connecting-yotpo-to-quiz-kit" id="connecting-yotpo-to-quiz-kit"></a>

Once you've installed Yotpo, you can connect it to Quiz Kit.

**Steps:**

1. From the Quiz Kit app menu, click **Integrations**.
2. Ensure the **Email marketing** tab is selected.
3. Under the Yotpo app, click **Connect**.

***

## Creating a customer list <a href="#creating-a-customer-list" id="creating-a-customer-list"></a>

**Steps:**

1. From the Yotpo dashboard, go to **List and Segments**.
2. Click **Create audience**, and then click **Create from list**.
3. Click on **New empty list** and give it a name.
4. Click **Save**.

***

## Setting up Yotpo to receive quiz submissions <a href="#setting-up-yotpo-to-receive-quiz-submissions" id="setting-up-yotpo-to-receive-quiz-submissions"></a>

**Steps:**

1. From the quiz builder, click **Settings**.
2. Click **Integrations**.
3. From the list of integrations, go to **Yotpo**, and click the drop-down arrow beside it.
4. Under **Available lists**, select the Yotpo list that you want to connect, and click **Save**.

***

## Creating flows based on your quiz answers <a href="#creating-flows-based-on-your-quiz-answers" id="creating-flows-based-on-your-quiz-answers"></a>

Once you have a list created, you can use it to build out a flow within Yotpo.

1. Open Yotpo and from the left-hand menu, click **Flow** > **My Flows**.
2. Click **Create flow**.
3. Start with a trigger. Click the **Choose trigger** button and scroll down on the list of options to find Quiz Kit.
4. Once selected, the trigger will branch out options and an end flow.
5. Click **Add condition**. Pick **Custom Profile Property** from the list of conditions.
6. Open the **Select custom property** dropdown and choose which quiz question you want to create a flow for. The list of questions that appear in Yotpo are the same as the ones you created in Quiz Kit.
7. Type: Text.
8. Select operation **contains** and type the answer your customer needs to select to qualify for your list.
9. Next, click **Add action**. On the left, click **Add to list** and pick from the lists you've already created, or add new list.
10. Continue building the flow as needed.


# PageFly

Learn how to embed your interactive quizzes using the PageFly drag-and-drop-builder.

The [PageFly](https://pagefly.io/?ref=presidio\&target=app-listing) integration allows you to add and configure Quiz Kit elements on your PageFly pages without any coding required.

## Connecting Quiz Kit to PageFly <a href="#connecting-quiz-kit-to-pagefly" id="connecting-quiz-kit-to-pagefly"></a>

### Part 1: Connect via Quiz Kit <a href="#part-1-connect-via-quiz-kit" id="part-1-connect-via-quiz-kit"></a>

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **More** tab, go to **PageFly Landing Page Builder.**
3. Click **Install**.

### Part 2: Connect via PageFly <a href="#part-2-connect-via-pagefly" id="part-2-connect-via-pagefly"></a>

**Steps:**

1. In the PageFly editor, from the left-hand menu, click **Add third-party element**.
2. Click **Manage integrations** or the gear icon on top.
3. Search for `Presidio` and enable it.
4. Click **Close** and the element appears in the **Add third-party element** menu.

***

## Configuring your quiz element <a href="#configuring-your-quiz-element" id="configuring-your-quiz-element"></a>

{% hint style="info" %}
**Important Note:**&#x20;

For full widget configuration, go to the **Settings** area of the Quiz Kit app. The Quiz Kit element can work on all page types, and one page can have many elements.
{% endhint %}

### **Part 1: Configure in Quiz Kit** <a href="#part-2-configure-in-quiz-kit" id="part-2-configure-in-quiz-kit"></a>

1. From your Quiz Kit dashboard, click **My Quizzes**.
2. Click **Create new quiz**.
3. Adjust any settings that you want.
4. Click on the **Publish** section and [publish the quiz](https://support.quizkitapp.com/~/changes/175/build-and-publish/publishing-your-quiz) where you want to.

### **Part 2: Configure in PageFly** <a href="#part-1-configure-in-pagefly" id="part-1-configure-in-pagefly"></a>

1. **Add Presidio: Quiz Kit Element**
   * From the left-hand menu, click **Add third-party element**.
   * Find the **Presidio: Quiz Kit** element.
   * Click on the element to see its variant.
   * Drag and drop the variant onto the page canvas.
2. **Configure Presidio: Quiz Kit Element**
   * Click on the element to adjust its settings.
   * From the **General** tab, configure the widget and select the quiz template from the Quiz Kit library.
   * For styling options like margins, borders, and effects, go to the **Styling** tab.


# Zapier

Learn how to integrate Zapier with the Quiz Kit app.

You can use many apps with Zapier through Quiz Kit integration.

{% hint style="info" %}
**Note:**

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

***

## **Connecting to Zapier to Quiz Kit** <a href="#connecting-to-zapier-to-quiz-kit" id="connecting-to-zapier-to-quiz-kit"></a>

Before you start, ensure that you have a [Zapier account](https://zapier.com/), and that you are logged into it.

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Analytics & Tracking** tab, go to **Zapier.**
3. Click **Settings**.
4. In the Zapier settings pop-up, you can find the setup instructions. [Follow the link](https://zapier.com/developer/public-invite/176154/69b68914ff8f95e38289d20a1f26733f) and click **Accept Invite & Build a Zap**.
5. Copy the store name & API key and finish the integration [here](https://zapier.com/engine/auth/start/App175947CLIAPI@1.0.0).
6. When prompted to allow Zapier access to Quiz Kit, click **Yes, continue**.

***

## Configuring Zapier <a href="#configuring-zapier" id="configuring-zapier"></a>

Before you start, log in and go to the Zapier dashboard.

Click **Create zap** to begin.

### **Configure a trigger** <a href="#configure-a-trigger" id="configure-a-trigger"></a>

**Steps:**

1. Search for and select `Quiz Kit` as the trigger app:
2. Select from two available trigger events:

* Quiz abandonment
* Quiz completed

1. Click **Continue** and follow the instructions to authenticate your Quiz Kit account and set up any necessary permissions:
2. Under **Choose an Account**, select Quiz Kit from the dropdown.
3. Click **Continue** and enter the Quiz key. To find your quiz key, from the quiz builder, click **Settings** > **Quiz**, then click **Copy** beside the key in the **Quiz key** section.
4. Paste the quiz key into the zap trigger tab under **Quiz key**, then click **Continue.**

***

## Test your zap <a href="#test-your-zap" id="test-your-zap"></a>

After completing the trigger setup, test your zap to ensure the trigger event works correctly.

**Steps:**

1. From your storefront, open the quiz connected to the zap you created, and complete it with a valid email address.
2. Return to the zap creation and under the **Test** tab, click **Test trigger**.
3. If the trigger was set up correctly, then test data is displayed here:

<figure><img src="/files/OrcVK6wNdXqaE2T19i9L" alt=""><figcaption></figcaption></figure>

4\. Click on **Continue with selected record** and proceed to the action step.

## Configure an action <a href="#configure-an-action" id="configure-an-action"></a>

Once you've completed the trigger setup, you can move on to configuring the action step of your zap.

**Steps:**

1. Click **Action** in the zap editor and search for the app that you want to connect with Quiz Kit.
2. Select the app and the specific action you want to perform when the trigger event occurs.
3. Follow the instructions to authenticate your chosen app and set up the required parameters for the action step. This varies depending on the app you selected.

### Custom properties <a href="#h_bd839048c2" id="h_bd839048c2"></a>

You can connect Quiz Kit custom properties to work with Google Sheets.

Custom properties act as variables that help you capture and describe key details based on customer responses.

1. Under **App & event**, select **Google Sheets**.
2. Under **Event**, choose the action. For example, **Create Spreadsheet Row**:

<figure><img src="/files/FyJrm8Zyq1ReppYAV4V4" alt=""><figcaption></figcaption></figure>

3. Click **Continue**.
4. Connect your Google account. Zapier might automatically connect accounts, or access permissions to create and edit documents, etc.
5. Set up the action.&#x20;
6. Create a spreadsheet that you want to use for collecting customers' data and add columns to the sheet. If you already have spreadsheet, then select it.
7. Once you select a spreadsheet and worksheet, Zapier pulls available column headers:

<figure><img src="/files/Qqc0nZEwquoXaohhEKl6" alt=""><figcaption></figcaption></figure>

8. Select the correct Quiz Kit custom properties for each columns:

<figure><img src="/files/vmK2hketuiM5AfAzh1to" alt=""><figcaption></figcaption></figure>

9. Proceed to the next step and click **Test action**:

<figure><img src="/files/zhyZFaL4wS6RaDbOlRza" alt=""><figcaption></figcaption></figure>

When you're satisfied with the setup, give your zap a name and turn it on.&#x20;

Your zap can now automate actions based on the trigger events from Quiz Kit.


# Analytics and tracking

Learn how to set up tracking through Facebook Pixel, Google Analytics, and more.

You can use Google Analytics or Meta Pixel to track how customers interact with your quiz. This includes actions like starting the quiz, completing it, or viewing specific product recommendations.&#x20;

Tracking these events helps you monitor performance and gather data for advertising or analysis.

## In this section:

* [Facebook Pixel](/building-a-quiz/integrations/analytics-and-tracking/meta-pixel-facebook-pixel)
* [Google Analytics](/building-a-quiz/integrations/analytics-and-tracking/google-analytics)
* [Additional marketing data](/building-a-quiz/integrations/analytics-and-tracking/additional-marketing-data)


# Meta Pixel (Facebook Pixel)

Learn about the Meta (Facebook) Pixel and how you can use it to track different actions on your quiz.

You can add your own Meta (Facebook) Pixel events to track different customer actions taken during your quiz, like quiz starts, completions, subscribes, and product added to cart events.

## In this section

* [Before you begin](#before-you-begin)
* [Connecting Quiz Kit to the Meta (Facebook) Pixel](#connecting-quiz-kit-to-the-meta-facebook-pixel)
* [Creating custom events](#creating-custom-events)

## Before you begin

Before you begin, you need to ensure you've enabled the Meta integration for your store, and have connected your tracking pixel.

You can learn more about [how to set up the integration](https://help.shopify.com/en/manual/promoting-marketing/analyze-marketing/meta-pixel).

***

## Connecting Quiz Kit to the Meta (Facebook) Pixel

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Analytics & Tracking** tab, go to **Facebook Pixel.**
3. Click **Enable**.

***

## Creating custom events

**Steps:**

1. From the quiz builder, click **Settings**.
2. Click **Tracking**.
3. On the **Facebook Pixel** tab, enter any custom event names for tracking information that you want.
4. Click **Save**.

Once setup is complete, events are tracked by the Facebook Pixel.&#x20;

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

You can test that the pixel is tracking accurately by installing [Meta's Pixel Helper](https://developers.facebook.com/docs/meta-pixel/support/pixel-helper/).
{% endhint %}


# Google Analytics

Learn how you can connect Google Analytics to Quiz Kit to track different events.

You can add Google Analytics events to track different actions taken in your quiz. The events that you can track are: quiz started, question answered, quiz completed, product added to cart, and customer subscribed.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

## In this section

* [Before you begin](#before-you-begin)
* [Connecting Quiz Kit to Google Analytics](#connecting-quiz-kit-to-google-analytics)
* [Creating custom events in Quiz Kit](#creating-custom-events-in-quiz-kit)
* [Adding custom tags to Google Tag Manager](#adding-custom-tags-to-google-tag-manager)
  * [Part 1: Create a trigger](#part-1-create-a-trigger)
  * [Part 2: Create a custom tag](#part-2-create-a-custom-tag)

***

## Before you begin

Before you begin, you need to ensure that you've enabled Google Analytics 4 for your store. You can learn more about how to get set up with [Google Analytics 4 on Shopify](https://help.shopify.com/en/manual/reports-and-analytics/google-analytics/google-analytics-setup).

***

## Connecting Quiz Kit to Google Analytics

**Steps:**

1. From the Quiz Kit dashboard, click **Integrations**.
2. On the **Analytics & Tracking** tab, go to **Google Analytics.**
3. Click **Enable**.

***

## Creating custom events in Quiz Kit

**Steps:**

1. From the quiz builder, click **Settings**.
2. Click **Tracking**.
3. Click the **Google Analytics** tab, and enter any custom event names for tracking information that you want. For example, for the quiz started event, you can write `quiz-started` .
4. Click **Save**.

{% hint style="info" %}
**Note:**

It's important to take note of the **event name** you created for each event.&#x20;

You need to copy and paste this event name in the trigger and tag setup of your Google Tag Manager, in order to have this event track properly.
{% endhint %}

***

## Adding custom tags to Google Tag Manager

### Part 1: Create a trigger

The first step in creating and tracking an event is to create the trigger in Google Tag Manager (GTM).

**Steps:**

1. From your GTM account, click **Triggers.**
2. Click **New**.&#x20;
3. Give your trigger a name so you can identify it later, for example, `Quiz started`.
4. Click under **Trigger configuration** to open the side panel.
5. Click **Custom event**.&#x20;
6. Under **Event name**, copy and paste the event name that you created in your Quiz Kit app. In this example, the event name is `quiz-started`.&#x20;
7. Click **Save**.

### Part 2: Create a custom tag

Next, you need to create a custom tag that references the trigger that you created in the previous section.&#x20;

{% hint style="info" %}
**Note**:\
\
You need your Measurement ID to complete this step.&#x20;

You can find your measurement ID in your Google Analytics 4 account under **Admin** > **Property** > **Data streams** > then click your website domain, and copy your Measurement ID.
{% endhint %}

**Steps:**

1. From your GTM account, click **Tags.**
2. Click **New**.&#x20;
3. Give your tag a name so you can identify it later, for example, `Quiz started`.
4. Click under **Tag configuration** to open the side panel.
5. Click **Google Analytics**, then click **Google Analytics 4**.
6. In the Measurement ID field, enter your ID.&#x20;
7. Under **Event name**, copy and paste the event name that you created in your Quiz Kit app. In this example, the event name is `quiz-started`.&#x20;
8. Click under **Triggers** and select the trigger that you created in the last section. &#x20;
9. Click **Save**.

This event is now being tracked.&#x20;

Repeat the steps in Part 1 and 2 for each event that you want Google Analytics to track.

<figure><img src="/files/tW3X6QbsMFC5b2IPCuQK" alt=""><figcaption></figcaption></figure>


# Additional marketing data

Learn how to enable additional marketing data for your quiz.

You can send additional information about your quiz results to third-party marketing services, such as apps like [Klaviyo](/building-a-quiz/integrations/email-and-sms/klaviyo).

## In this section

* [Collecting additional marketing data](#how-to-connect)
* [Add a marketing property name](#add-a-marketing-property-name)

***

## **Collecting additional marketing data** <a href="#how-to-connect" id="how-to-connect"></a>

By default, your quiz is set up to collect and pass specific data to your marketing integrations. Data collected by default is quiz name, quiz completion data, discount code, products (Klaviyo only), and customer answers.&#x20;

You can decide to deselect any of these options if you don't want to pass that specific data.&#x20;

**Steps:**&#x20;

1. From the quiz builder, click **Settings**.
2. Click **Integrations**.&#x20;
3. Under **Custom properties**, uncheck any of the data options that you don't want to be passed on to your marketing integrations.
4. Click **Save**.&#x20;

***

## Add a marketing property name

You can change the marketing property name of the quiz questions. The marketing property name is the identifier that is passed to you marketing integrations.&#x20;

For example, if you have a question that asks: `What is your skincare type?`  you can add a name for this question that's just `skincare-type` so that the entire question doesn't get passed, but a short form of it.&#x20;

**Steps:**

1. From the quiz builder, click a question.
2. On the right-hand panel, go to **Settings**.
3. In the text field under **Marketing property name (optional)**, type the name you want passed to your marketing integrations.
4. Click **Save**.


# Publishing your quiz

Publish your quiz so it's live and discoverable to your customers.

When you’ve finalized your quiz, you can publish it to your store through several methods. You can [add your quiz to a page](#publishing-your-quiz-on-a-page), [add it as a section on a page](#publishing-as-a-section-on-a-page), [embed it as a pop-up](#embedding-your-quiz-as-a-pop-up), and [embed it as a code snippet](#embedding-your-quiz-as-a-code-snippet).&#x20;

Once you've published your quiz in any of the available methods, it will be live and discoverable to your customers.

## In this section

* [Making your quiz live](#making-your-quiz-live)
* [Publishing your quiz on a page](#publishing-your-quiz-on-a-page)
* [Publishing as a section on a page](#publishing-as-a-section-on-a-page)
* [Embedding your quiz as a code snippet](#embedding-your-quiz-as-a-code-snippet)
* [Embedding your quiz as a pop-up](#embedding-your-quiz-as-a-page-pop-up)

***

{% embed url="<https://www.youtube.com/watch?v=yPnqpp0pLyE>" %}

## Making your quiz live

You need to make your quiz live on your store before you can publish it to any other location.&#x20;

**Steps:**

1. From the Quiz Kit app, click **My Quizzes**, then click **Customize** on the quiz that you want to publish.
2. On the left-side menu, click the globe icon to navigate to the **Publish** settings.
3. By default, your quiz is in draft mode. Click the toggle beside `Ready to publish` to publish your quiz.

Once your quiz is live, additional publication options appear below. &#x20;

By default, a quiz that you publish to your store creates a new page in the **Pages** section of your Shopify admin and a live customer-facing page in your store.&#x20;

Your quiz's unique page is only discoverable to customers if you give them the page link or if you publish it by any of the methods detailed below.

***

## Publishing your quiz on a page

By default, making your quiz live as detailed above automatically creates a page in the **Pages** section of your Shopify admin. You can further edit and publish this standalone page to your preference. <br>

**Steps:**

1. From the **Publish** menu in the Quiz Kit app, go to the **Add to a page** section.
2. To preview the quiz on your page with the current publication settings, click **Preview** **page**. When you’re done, click **Close preview** to exit the preview mode.
3. If you want to make edits to your page settings before publication, then take note of what page name displays beside **Published on**. You can then locate it in the **Pages** section of the Shopify admin.
4. Click on the page you want to edit, make any changes you want, and then click **Save**.

Your quiz displays on the selected page.

You can also choose to hide this page when your quiz is published by clicking the **Visible** button and selecting **Hidden** from the drop-down.

{% hint style="info" %}
**Note:** If you want your quiz to be full-width on your pages, you can create a new template. You can apply the same template to any quiz page. [Learn more about making your quiz full-width](https://support.quizkitapp.com/faqs/how-do-i-make-published-quiz-on-a-page-full-width).
{% endhint %}

***

## [8 Key Places to Promote your AI Product Quiz](https://www.quizkitapp.com/blogs/our-blog/8-places-to-promote-your-ai-product-quiz/)

<figure><img src="/files/5WzDfRKTcdqRKJHksucS" alt=""><figcaption></figcaption></figure>

***

## Publishing as a section on a page

You can add your quiz as a section on a page. You need to follow different instructions depending on whether your current store theme is an Online Store 2.0 theme or a Vintage theme. [Learn more about Shopify’s theme versions.](https://help.shopify.com/en/manual/online-store/themes/managing-themes/versions)

### Add a section to Online store 2.0

**Steps:**

1. From the **Publish** menu in the Quiz Kit app, go to the **Add as a section to a page** section, then click **View instructions**.
2. Under step 1: **Copy your quiz key**, click the clipboard icon to copy it.
3. Under step 2, click **Select theme** and then click the theme that you want to add the section to.
4. Click **Add to theme**. This launches a new tab with the theme editor.
5. By default, the section is added to your homepage, but you can move it to any page in the theme editor.
6. Under **Apps**, click the new section block to open the settings, and paste the previously copied quiz key in the **Quiz key** field. The quiz displays in the preview modal of your theme editor. You can drag the section to reorder if needed.
7. Click **Save**.

### Add a section to a Vintage theme

#### Part 1: Add a new template to your theme

1. From the **Publish** menu in the Quiz Kit app, click **Add as a Section** on a page.
2. Click **Vintage themes** from the tabs at the top of the section.
3. Click **Copy** under the block of code to copy it to your clipboard.
4. From the Shopify admin, click **Online Store**.
5. Click **Themes**, then click **…** to display more options, then click **Edit code**.
6. Click **Sections**, then click **Add a new section**.
7. Ensure liquid is selected, and enter quiz-kit-app under **File name**.
8. Click **Done**.
9. Select and delete all the code in the new template that you’ve created.
10. Paste the previously copied code from your clipboard into the blank template.
11. Click **Save**.

{% hint style="info" %}
**Note:** If you later uninstall the Quiz Kit app, this template will also need to be deleted.
{% endhint %}

#### Part 2: Add the section to your theme

1. From the app instructions page, in section 2, click **Copy** to copy your quiz code.
2. In the theme editor, go to the page you want to embed the quiz on.
3. Under **Template**, click **Add a section**.
4. Click **Apps** to search from the correct list, then select **Quiz** from the list of apps.
5. Click the new section block to open the settings, and paste the previously copied quiz key in the **Quiz Key** field. The quiz displays in the preview modal of your theme editor. You can drag the section to reorder if needed.
6. Click **Save**.

***

## Embedding your quiz as a code snippet

**Steps:**

1. From the **Publish** menu in the Quiz Kit app, go to the **Embed with code** **snippet** section, then click **View instructions.**
2. Under step 1: **Copy the code**, click the clipboard to copy the snippet to your clipboard.
3. Under step 2, click **Select theme**, then click the theme that you want to add the section to.
4. Click **Edit theme code**. This launches the theme code editor in a new tab.
5. Click the file in your theme that you want to add the code to, then paste the code.
6. Click **Save**.

{% hint style="info" %}
**Note:**&#x20;

If you later uninstall the Quiz Kit app, this template will [also need to be deleted](/account-and-settings/billing-and-account#step-1-uninstall-the-app-and-cancel-your-subscription).
{% endhint %}

***

## Embedding your quiz as a page pop-up

You can embed your quiz so that it pops up when your customer navigates to a specific page, or if they click on a specific button or menu item. There are different setup methods for each option.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

**Steps:**

1. From the **Publish** menu in the Quiz Kit app, go to the **Embed as a popup** section, then click **View instructions**.
2. Beside **Ready to publish**, click the toggle to make the quiz live.&#x20;
3. Under **Embed as a popup**, click **View instructions**.
4. Click **Set up** under the option you want to use:
   1. [**Launch from menu or button**](#launch-from-menu-or-button)
   2. [**Automatically launch quiz**](#automatically-launch-quiz)

### Launch from menu or button

1. Next to **Copy the code**, click the clipboard icon to copy it.
2. For a **menu item**, do the following:
   1. Navigate to the **Online Store** > **Content** > **Menus** section of your Shopify admin.
   2. Select a menu item, then click **Add menu item**.
   3. Paste your previously copied code from the clipboard into the **Link** field.&#x20;
   4. The **Label** field will auto-populate. To change it, click the field and edit the text.
3. For a **button**, go to the button in you theme editor, and paste code into the link field.
4. Click **Save**.

### Automatically launch quiz

1. For automatic launch, select a theme to publish it to from the drop-down menu, then click **Open theme editor**.
2. Under **Trigger type:** Set when the popup launches to a new customer.
3. Under **Show on:** Choose **All pages** or just the **Homepage**.
4. Click **Save**.


# Publishing on page builder apps or headless setups

Learn how to integrate Quiz Kit with page builder apps or headless setups.

After a quiz is published to any theme, you can connect it to a page builder app or headless setup.

**Steps:**

1. From the quiz builder menu, click **Publish**.
2. From the **Publish** menu, click **Embed with code snippet**.
3. Copy the code in step 1 by clicking **Copy**.
4. Navigate to your page builder settings or your headless setup files and paste the code you just copied in the appropriate location.
5. Copy the following script and then paste it above the code you copy and pasted in steps 3 & 4.

```
<link type="text/css" rel="stylesheet" href="https://d38jc50suw8dg3.cloudfront.net/current/static/main.min.css" media="all">
<script async="" src="https://d38jc50suw8dg3.cloudfront.net/current/static/bundle.min.js"></script>
```

4. Save your changes.


# Visibility and placement

A well-placed quiz can boost conversion, average order value, and data capture. Strategic placement can make the quiz feel like a natural next step in the shopping journey, promoting engagement without hurting customer experience.&#x20;

## Where to place your quiz:

1. [Homepage and navigation](#homepage-and-navigation)
2. [Pop-ups, modals & announcement bars](#id-2.-pop-ups-modals-and-annoucement-bars)
3. [Dedicated landing page](#id-3.-dedicated-landing-page)
4. [Product & collection pages](#id-4.-product-and-collection-pages)

***

### Homepage and navigation

<table><thead><tr><th width="141.24609375">Placement</th><th width="224.4765625">Why it works</th><th>How to do it</th></tr></thead><tbody><tr><td><strong>Hero banner</strong></td><td>Eye-level real estate grabs first-time visitors.</td><td>Add a full-width image + call-to-action (CTA): <strong>“Not sure what’s right? Take the quiz →”</strong> linking to your quiz page.</td></tr><tr><td><strong>Top-nav link</strong></td><td>Keeps the quiz one click away on every page.</td><td>In <strong>Content > Menus</strong>, add a parent item (for example, named <strong>"Quiz"</strong> or <strong>"Gift Finder"</strong>) and paste the quiz URL.</td></tr><tr><td><strong>Homepage section</strong></td><td>Reinforces the quiz alongside best sellers or promos.</td><td>Insert a rich-text section with a brief benefit explanation and a <strong>Start Quiz</strong> button.</td></tr></tbody></table>

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

A new visitor should be able to find the quiz in 10 seconds or less.&#x20;
{% endhint %}

***

### Pop-ups, modals and announcement bars

<table><thead><tr><th width="197.7109375">Tactic</th><th>Trigger</th><th>Goal</th></tr></thead><tbody><tr><td><strong>Entry pop-up</strong></td><td>Opens ~5 s after page load.</td><td>Catch curious customers before they leave the store.</td></tr><tr><td><strong>Exit-intent pop-up</strong></td><td>Pops up when cursor heads for the address bar.</td><td>Prompt customers who are leaving with a helpful next step.</td></tr><tr><td><strong>Announcement bar</strong></td><td>Sticky bar across the site.</td><td>Subtle reminder (for example, “Find your match in 30 seconds”).</td></tr></tbody></table>

{% hint style="success" %}
You can use any pop-up tool, you just need to drop in the shareable Quiz Kit URL.
{% endhint %}

***

### Dedicated landing page

A page specifically for your quiz can make your website easier to find (better Search Engine Optimization (SEO)), seasonal marketing campaigns, and paid ads.

**What to include on the page (Checklist):**

* [ ] A clear headline (known as the H1) with keywords (for example, “Find Your Perfect Skincare Routine”)
* [ ] A short introduction (80–100 words) explaining why the quiz or product is helpful
* [ ] A big, easy-to-find **Start Quiz** button near the top of the page
* [ ] Photos showing real people using the product or happy customers

{% hint style="success" %}
**Tip:**&#x20;

If you’re sharing the page on Google, Facebook, or Instagram, then you can send people **directly to this page** for better results and more sales.
{% endhint %}

***

### Product and collection pages

Capture buyers as they're deciding to buy:

1. In **Quiz Kit > Publish > Embed with code snippet**, copy the code.
2. Paste it into your product-page template (above **Add to Cart** or under the description).
3. Save and test on mobile and desktop.

***

### Email, SMS and social media

<table><thead><tr><th width="173.58984375">Channel</th><th width="330.15234375">Example</th><th>Link placement</th></tr></thead><tbody><tr><td><strong>Welcome</strong> <strong>email</strong></td><td>“Still unsure? Find your perfect match in 30 seconds.”</td><td>Primary CTA button</td></tr><tr><td><strong>SMS</strong></td><td>“Take the four question quiz + get 15 % off → [link]”</td><td>Short quiz URL</td></tr><tr><td><strong>Instagram reel</strong></td><td>15-sec walk-through of quiz results</td><td>Bio link + story sticker</td></tr><tr><td><strong>TikTok</strong></td><td>POV: “Me after taking the shade-finder quiz 👀”</td><td>Link in profile</td></tr><tr><td><strong>Pinterest pin</strong></td><td>Static graphic: “Not sure where to start?”</td><td>Pin URL → quiz page</td></tr></tbody></table>


# Customize your results email sender

Learn how to update the sender name and email address on your quiz results emails.

By default, Quiz Kit sends results emails from a `quizkitapp.com` email address. You can update the sender name and email address to reflect your brand, so customers recognize the email as coming from your store.

### Before you begin

To change your email sender address to a custom domain, you need to verify the domain with Quiz Kit by adding your domain's DNS records. Locate these in your domain provider before you begin.

You can only set up this feature for custom domains you own, not for email addresses like `gmail.com`, `yahoo.com` etc.

## Set up your results email sender&#x20;

You only need to set up your custom email sender address once within Quiz Kit, but you need to enable the feature to send quiz results in each quiz that you want to apply it to.

**Steps:**

1. From the quiz builder, go to **Results email template** in the left-hand menu.
2. In the **Display settings** section, check the **Send customer results via email** option.
3. Click **Edit email sender**.
4. In the **Sender name** field, enter the name you want displayed to customers.
5. In the **Email address** field, enter the email address you want the results email sent from.
6. Enter the DNS records required. Contact your domain provider if you need help locating these records.
7. Click **Verify**.

DNS changes can take a few minutes to populate.

Once verified, any quizzes that you enable **Send customer results via email** for will use your custom domain email address.


# Personalizing your quiz

Add features that personalize the customer experience in your store after a customer has taken a quiz.

You can set up certain features in your quiz so that once a customer has taken it, they have a personalized and enhanced experience based on their quiz results.

{% hint style="info" %}
**Note:**&#x20;

If you’re on a legacy Quiz Kit plan, then this feature is available for the **Middle** plan or higher.
{% endhint %}

Personalization features that you can add are:

* Status updates for returning customers
* Dynamic settings to personalize your store's navigation menu
* Integration of a "Your match" block, for products matching customers' quiz results
* A dedicated section for recommended products

## In this section

* [Enabling quiz personalization](#enabling-quiz-personalization)
* [Dynamic navigation settings](#dynamic-navigation-settings)
* [Updating the quiz label in the navigation](#updating-the-quiz-label-in-the-navigation)
* [Adding a "Your Match" block](#adding-a-your-match-block)
* [Adding a Recommended Products section](#adding-a-recommended-products-section)

***

## Enabling quiz personalization

To enable and adjust any personalization features, first you need to turn on the general quiz personalization feature.

{% hint style="info" %}
**Note**

Personalization relies on the customer’s quiz results, which are stored in their browser cookies. If the cookies are cleared, this data is deleted and the quiz results are no longer remembered.
{% endhint %}

**Steps:**

1. From the Quiz builder, click the gear wheel to access the **Settings** menu, then click **Personalization**.
2. Under **Status**, click the drop-down menu and select **Enabled**.
3. Optional: Check **Show results if available** if you want to show customers who already completed the quiz their results page if they access the quiz again.
4. Click **Save**.

***

## Dynamic navigation settings

You can personalize your customer's experience with your online store's navigation menu after they have taken a quiz.&#x20;

New customers who click the navigation are directed to your quiz, while return customers who have already completed the quiz are directed to their previous results, which are highlighted in the navigation.

In this section of the **Personalization** page you can click the drop-down arrow to access the following options:\
\
\- **Open quiz results in a popup**: Check this box to have the quiz results open in a new popup window if a customer accesses the quiz after completing it. \
**- Update the label**: Check the box to have the navigation menu change after a customer takes the quiz. You can customize the label name.

### Updating the quiz label in the navigation

{% hint style="info" %}
**Note:** A [video version](https://www.dropbox.com/scl/fi/eaxyo7qdjsj56jrog6y45/My-matches-Publish-as-a-link.mov?rlkey=v0w8iwiizrfsak4m3rogclqrg\&e=2\&dl=0) of this tutorial is available.
{% endhint %}

If you checked **Show results if available** in the **Enabling quiz personalization** section, customers see their results if they access the quiz again.&#x20;

To further personalize this experience, you might also want to update the quiz's label in your store's navigation menu after a customer has completed a quiz, for example to "My matches" or "My quiz results".

**Steps:**

1. From the Quiz builder's **Settings** > **Personalization** menu, click the drop-down arrow in the **Dynamic Navigation** settings.
2. Check **Update the label**.
3. In step 1's **Edit the label** field, enter the label that you want to display in the store's navigation after a customer has completed taking the quiz.
4. Click **Copy** to copy the code in step 2.
5. Open a new tab, or click **Save** in this tab to ensure you don't lose your changes, and then navigate to **Content** > **Menus**.
6. Click on the menu name that your quiz is on, then click **Edit** beside the quiz menu item.
7. Paste the link you copied into the **Link** field.
8. Click **Save**.

***

## Adding a "Your Match" block

If your quiz matches customers with particular products, then you can add a "Your Match" block to the matched products after the customer completes the quiz.

You need to follow different instructions depending on if your current store theme is an Online Store 2.0 theme or a Vintage theme. [Learn more about Shopify’s theme versions.](https://help.shopify.com/en/manual/online-store/themes/managing-themes/versions)

### Add a "Your Match" block to an Online Store 2.0 theme

{% hint style="info" %}
**Note:** A [video version](https://www.dropbox.com/scl/fi/4r5oqja73wywr7r8nqy04/Add-Your-match-badge-theme-2.0.mov?rlkey=6kno3kllngqerk1n4mvnt4o4m\&e=1\&dl=0) of this tutorial is available.
{% endhint %}

**Steps:**

1. From the Shopify admin, navigate to **Online Store** > **Themes**, then click **Customize** on the theme you want to edit.
2. Navigate to a product that you want to apply the block to.
3. Click **Add section**, then search for the **"Your Match" badge** block in the **Apps** section and click it.
4. Optional: Click the block again to open the settings and styles for the block and edit anything you want. You can click and drag the section to reorder it on the page.
5. Click **Save**.

### Add a "Your Match" block to a Vintage theme

{% hint style="info" %}
**Note:** A [video version](https://www.dropbox.com/scl/fi/leusy5w6vj09uhvl8dyoq/Adding-Match-block-to-liquid-file.mov?rlkey=zotu4cwq8pvw0onqyaiivy0tp\&e=1\&dl=0) of this tutorial is available.
{% endhint %}

**Steps:**

1. From the Quiz builder's **Settings** > **Personalization** menu, click the drop-down arrow in the **Add "Your Match" block** settings.
2. Click the **Vintage themes** tab.
3. In step 1, click **Copy** to copy the code displayed.
4. From the Shopify admin, click **Online Store > Themes.**
5. Click **…** to display more options, then click **Edit code**.
6. Add the code to any Liquid file in your theme. Make sure to remove this code if you uninstall the app.
7. Click **Save**.

***

## Adding a Recommended Products section

{% hint style="info" %}
**Note:** A [video version](https://www.dropbox.com/scl/fi/3yrwa8s8t7wbsk6r5swu7/Adding-Recommended-products-themes-2.0.mov?rlkey=bjkb6i8lrkl513fjl8cdama4h\&e=1\&dl=0) of this tutorial is available.
{% endhint %}

You can add a Recommended Products section to your theme that automatically recommends products to your customer based on their quiz results.&#x20;

Alternatively, you can also **enable smart recommendations**, which finds the best product recommendations based on Shopify's algorithm and quiz data.

To add a Recommended Products section to your theme, you need to follow different instructions depending on if your current store theme is an Online Store 2.0 theme or a Vintage theme. [Learn more about Shopify’s theme versions.](https://help.shopify.com/en/manual/online-store/themes/managing-themes/versions)

### Add a Recommended Products section to an Online store 2.0 theme

**Steps:**

1. From the Quiz builder's **Settings** > **Personalization** menu, click the drop-down arrow in the **Add "Recommended products"** section.
2. In step 1, click **Copy** to copy the quiz key displayed.
3. From the Shopify admin, navigate to **Online Store** > **Themes**, then click **Customize** on the theme you want to edit.
4. Click **Add section**, then search for the **Recommended Products** block in the **Apps** section and click it.
5. Click the block you just added, and paste the quiz key that you previously copied into **Quiz key** field. You can click and drag the section to reorder it on the page.
6. Click **Save**.

### Add a Recommended Products section to a Vintage theme

**Steps:**

1. From the Quiz builder's **Settings** > **Personalization** menu, click the drop-down arrow in the **Add "Recommended products"** section.
2. Click the **Vintage themes** tab.
3. Enter any heading you want your customers to see under **Section heading.**
4. Check the options for where you want product recommendations to be displayed to customers who have already taken the quiz.
5. Click **Save**.

After enabling these options, if a customer completes the quiz, their matches will show up as a section above the footer menu on the selected pages.


# Dynamic questions & answers

Learn how you can personalize quiz questions or results with user responses collected earlier in the quiz.

You can collect specific customer data during your quiz, such as names, that you use in follow-up questions or results to personalize the experience.

There are two ways to do so depending on the question type.

## In this section

* [Personalizing form question types](#personalizing-form-question-types)
* [Personalizing other question types](#personalizing-other-question-types)

***

## Personalizing form question types

For form and contact form questions, you can use customer data that's entered in to personalize the subsequent questions.&#x20;

The following steps use the example of collecting the customer's name.

**Steps:**

1. From the quiz builder, navigate to the question and field where you want to collect data to personalize follow-up questions.
2. Under **Content**, in the **Name** text field, add a variable name. For example, if you want to collect a customer's first name, then give it a recognizable variable name like `FirstName`**.**
3. Navigate to the question where you want to use the customer's first name. Add the same variable name (`{FirstName}`) wherever you want the first name to show up.&#x20;

For example, in the **Heading** text section, you might write `Hello {FirstName}!` which would display the user's first name instead when they take the quiz.

You can use variables in the next question's **Heading**, **Subheading**, and **Bottom text.** You can also use it in the **Results** page's **Text, Subheading**, and **Heading.**

Additionally, you can use them in the **Email subtitle**, **Email title**, and **Email description** of the **Results email template**. &#x20;

***

## Personalizing with answers

You can use the answers from previous questions to personalize follow-up questions. \
\
Each question in your quiz has a number representing the order it appears in your quiz.&#x20;

For example, question #1 in a quiz is `What's your favorite flavor?`  If you want to reference the flavor choice in question #2, then in question #2 you include the variable `{1}` since it's the answer for question #1.

<figure><img src="/files/HUfCAn8A1dYvulO8mgwx" alt=""><figcaption></figcaption></figure>


# Multilingual quiz workaround

Learn how to offer translated versions of your quiz by routing customers to language-specific quizzes.

Quiz Kit doesn’t currently integrate with multilingual apps or automatically translate quiz content. However, you can still provide quizzes in multiple languages by creating separate translated versions of your main quiz.

To set this up, translate your main quiz into each language you want to support, then create a short language selector quiz. When customers choose their answer (the language), the quiz sends them to the corresponding translated quiz.

{% hint style="warning" %}
**Limitations**

Product titles and descriptions can’t be translated within Quiz Kit; they’re always pulled from your Shopify admin in the language used there.\
\
Additionally, at this time Quiz Kit also doesn’t integrate with translation apps, so all quiz content must be translated manually.
{% endhint %}

## In this section

* [Creating the multilingual quiz workaround](#creating-the-translated-quiz-workaround)
  * [Step 1: Create a quiz in one language](#step-1-create-a-quiz-in-one-language)
  * [Step 2: Duplicate the quiz for each additional language](#step-2-duplicate-the-quiz-for-each-language)
  * [Step 3: Create another quiz for language selection](#step-3-create-another-quiz-for-language-selection)

***

## Creating the multilingual quiz workaround

### Step 1: Create a quiz in one language

Create or locate an existing quiz that you want to translate. You'll use this quiz to base the translated versions on.

### Step 2: Duplicate the quiz for each language&#x20;

Next, duplicate your main quiz once for each additional language needed. For example, if your original quiz is in English, and you want it in French, Japanese, and Spanish, then you need to duplicate the English quiz three times.&#x20;

Manually [translate](https://support.quizkitapp.com/navigating-the-interface/quiz-builder/settings#translations) each duplicated quiz into its respective language, then [publish each quiz to a unique page](https://support.quizkitapp.com/navigating-the-interface/quiz-builder/publish) in your store.

**Steps:**

1. From the Quiz Kit app dashboard, under the **Quiz library**, locate the quiz you want to duplicate.
2. Beside the quiz, click the ellipsis (**`…`**) for more options.
3. Click **Duplicate**.
4. Repeat steps 1-3 for each language your want to create.
5. Optional: Rename each quiz to the language you're translating it to. By clicking **Customize** > **Settings**, then adding a new name under **Quiz name**.
6. [Translate](/account-and-settings/quiz-builder/settings#translations) the quizzes manually.&#x20;
7. Follow the steps on [Publishing your quiz](/publish-and-launch/publishing-your-quiz#publishing-your-quiz-on-a-page) to publish each new language quiz to a unique page, and take note of the link for each quiz.

{% hint style="info" %}
**Note**

To find your newly duplicated quiz, you may need to sort your quizzes by **Most recent edit**, or click **View all** to find it at the bottom of the quiz list.
{% endhint %}

### Step 3: Create another quiz for language selection

When you have your separate language quizzes all published to page, then you can create the "language selection" quiz.

This quiz should contain a single question asking which language the customer would like to continue in.&#x20;

**Steps:**

1. From the Quiz Kit app dashboard, click **Create new quiz** > **Start with a blank template**.
2. Optional: Change the introduction page if you want, or keep it hidden.
3. In the first question, click **Content** and under heading, and enter text that works for your quiz, like `What's your preferred language?`
4. Click **Answers**. For each answer:
   1. Change the **Answer** text to a language name that you want as an option, for example `Spanish`.
   2. Check **Custom redirect URL**, and add the quiz link for the correct language.
5. Repeat step 4 for each language that you created your quiz in.
6. Click **Save**.

This method provides a multi-language experience for your customers and offers flexibility for any future language additions.


# Common code customizations

Learn how to customize Quiz Kit with custom CSS, HTML, and JavaScript.

Quiz Kit allows you to add custom CSS and JavaScript to fine-tune the look and behavior of your quiz. Many merchants and developers use these options for branding or advanced customization.&#x20;

{% hint style="warning" %}
**Important:**&#x20;

**Custom code is use-at-your-own-risk**

Custom code is use-at-your-own-risk. Quiz Kit’s classes, IDs, and DOM structure may change in any release, which can break custom CSS or scripts. Targeting element IDs is generally safer than div classes, but there’s still some risk. Quiz Kit does not notify users of changes, so you should review and maintain any custom code regularly.
{% endhint %}

## In this section

* [Adding custom code and JavaScript](#adding-custom-code-and-javascript)
* [Common quiz code customizations](#common-quiz-code-customizations)
  * [Functional/behavioural code](#functional-behavioral-code)
  * [Content and layout (custom HTML)](#content-and-layout-custom-html)
* [Common custom JavaScript events](#common-custom-javascript-events)

***

## Adding custom code

There are several ways to can add custom code to your quiz. See the [Adding custom code to quizzes](/building-a-quiz/styling-and-designing-your-quiz/adding-custom-code-to-quizzes) are page for full instructions.

***

## Common quiz code customizations

Quiz Kit supports custom code for merchants and developers who want more control over styling or behavior. Always duplicate your quiz, and your theme if editing theme code, before making any changes.

{% hint style="info" %}
**Note**

Code customizations are only visible on the storefront, not within the quiz builder preview.
{% endhint %}

### Functional/behavioral code

Use this type of code to change how your quizzes behave, like button colors and cart behavior. Always test carefully and keep backups of your theme and quiz.&#x20;

{% hint style="warning" %}
**Important:**&#x20;

**Only proceed if you’re comfortable with code**

Incorrect or outdated code can break your quiz display. If you're not confident in reviewing or updating custom code, work with a developer who can support you when updates occur.
{% endhint %}

{% hint style="success" %}
**Duplicate your quiz and theme first**\
Always create a duplicate of your quiz, and ideally your theme if you're editing theme code, before making any code changes. This gives you a safe version to revert to if something breaks.
{% endhint %}

<table><thead><tr><th>Customization</th><th width="286.87109375">Global CSS</th><th>JavaScript (JS)</th></tr></thead><tbody><tr><td><strong>Questions to appear vertically inline</strong><br>(<a href="https://www.loom.com/share/690122f867254295a5ccc1c2a3eb9b99">video tutorial</a>)</td><td><p><strong>Button inline (all quiz pages)</strong></p><p><code>[id*="quiz-kit-question-grid"] > div > div {</code></p><p>  <code>display: flex !important;</code></p><p>  <code>flex-direction: row !important;</code></p><p>  <code>flex-wrap: wrap !important;</code></p><p>  <code>gap: 16px !important;</code></p><p>  <code>justify-content: center !important;</code></p><p><code>}</code></p><p><br></p><p><code>[id*="quiz-kit-question-multiple-choice"] {</code></p><p>  <code>width: 475px !important;</code></p><p>  <code>flex-shrink: 0 !important;</code></p><p><code>}</code></p></td><td>N/A</td></tr><tr><td><strong>Button hover color</strong><br>(<a href="https://www.loom.com/share/7b8abbc9203b4be8954d738ed64a2cc5">video tutorial</a>)</td><td><p><code>[id*="quiz-kit-question-multiple-choice"] button:hover,</code></p><p><code>#quiz-kit-intro-button:hover {</code></p><p>    <code>background-color: #000000!important;</code></p><p>    <code>color: black !important;</code></p><p>    <code>outline: none !important;</code></p><p><code>}</code></p></td><td>N/A</td></tr><tr><td><strong>Add background image to the results page</strong><br>(<a href="https://www.loom.com/share/78cbcb08cc704b189b1b58bfed04eaf7">video tutorial</a>)</td><td><p><strong>Add background image to the entire result page</strong></p><p><code>#quiz-kit-result-advanced-wrapper {</code></p><p>    <code>background-image: url('IMAGE URL HERE');</code></p><p>    <code>background-size: cover;</code></p><p>    <code>background-position: center;</code></p><p>    <code>background-repeat: no-repeat;</code></p><p>    <code>background-attachment: fixed;</code></p><p>    <code>min-height: 100vh;</code></p><p><code>}</code></p><p></p><p><strong>Optional: Add overlay for better text readability</strong> </p><p><code>#quiz-kit-result-advanced-wrapper::before {</code></p><p>    <code>content: '';</code></p><p>    <code>position: absolute;</code></p><p>    <code>top: 0;</code></p><p>    <code>left: 0;</code></p><p>    <code>right: 0;</code></p><p>    <code>bottom: 0;</code></p><p>    <code>background: rgba(255, 255, 255, 0.8); /* White overlay with 80% opacity */</code></p><p>    <code>z-index: 0;</code></p><p><code>}</code></p></td><td>N/A</td></tr><tr><td><strong>Full Ajax cart integration</strong></td><td>N/A</td><td><p>Full Ajax cart integration sometimes requires custom coding inside of your Shopify theme directory. You or your developer need to trigger “cart refresh + cart open”.</p><p>Contact support for assistance: <code>support@quizkitapp.com</code><br></p><p>Code required:</p><p></p><p><code>&#x3C;script></code></p><p><code>document.addEventListener(‘quizKitAddToCartSuccess’, function () {</code></p><p><code>// insert cart refresh + cart open code here</code></p><p><code>}, false);</code></p><p><code>&#x3C;/script></code></p></td></tr></tbody></table>

### Content and layout (custom HTML)

Use HTML for paragraphs, line breaks, lists, links, and text formatting.&#x20;

{% hint style="success" %}
**Note:**\
\
Most text fields in Quiz Kit support HTML. You can add HTML directly to the copy you want to edit, such as paragraphs, lists, links, and formatting.
{% endhint %}

<table><thead><tr><th width="243.609375">Customization</th><th>HTML</th></tr></thead><tbody><tr><td>Paragraph</td><td><code>&#x3C;p>This is a paragraph.&#x3C;/p></code><br><code>&#x3C;p>This is another paragraph.&#x3C;/p></code></td></tr><tr><td>Line break inside text</td><td><code>&#x3C;br></code></td></tr><tr><td>Bold / Italic text</td><td><code>&#x3C;b>Bold text&#x3C;/b></code><br><code>&#x3C;strong>Important text&#x3C;/strong></code><br><code>&#x3C;i>Italic text&#x3C;/i></code></td></tr><tr><td>Unordered list</td><td><code>&#x3C;ul></code><br><code>&#x3C;li>First item&#x3C;/li></code><br><code>&#x3C;li>Second item&#x3C;/li></code><br><code>&#x3C;/ul></code></td></tr><tr><td>Ordered list</td><td><code>&#x3C;ol></code><br><code>&#x3C;li>Step one&#x3C;/li></code><br><code>&#x3C;li>Step two&#x3C;/li></code><br><code>&#x3C;/ol></code></td></tr><tr><td>Links</td><td><code>&#x3C;a href="</code><a href="https://example.com/"><code>https://example.com</code></a><code>">Link text&#x3C;/a></code></td></tr></tbody></table>

***

## Common custom JavaScript events

The following are JavaScript events that you can use for different purposes.

1. ***"quizKitQuestionLoaded"*** event. This event fires when your customer lands on the question page. You can use this event to add custom labels, text, and content to particular questions. This event will contain question data in the the following format:

```
{ 
  question: { all question data will be here }
}
```

Add the code below to catch this event:

```
document.addEventListener('quizKitQuestionLoaded', function (e) {
  // console.log(e.detail);  
  // e.detail will contain question data
}, false);
```

2. ***"quizKitCapturePageLoaded"*** event. This event fires when your customer lands on the email capture page. You can add additional checkboxes or other elements to this page. Add the code below to catch this event:

```
document.addEventListener('quizKitCapturePageLoaded', function (e) {
  // add your code here 
}, false);
```

3. ***"quizKitResultsPageLoaded"*** event. This event fires when your customer lands on the result page. You can use this event to send your quiz data anywhere. This event will contain quiz data in the following format:

```
{ 
  answers: [questions names and chosen answers],
  email: 'customer email',   
  result: { all the data about current result page },
  recommendedProducts: [recommended products], 
}
```

Add the code below to catch this event:

```
document.addEventListener('quizKitResultsPageLoaded', function (e) {  
  // console.log(e.detail); 
  // loop through the data (e.detail) and send it anywhere or use it for your needs
}, false);
```

4. ***"quizKitAddToCart" event***. This event fires each time your customers click the "Add to bag" button on your quiz result page. This event fires before items are actually added to cart.&#x20;

Add the code below to catch this event:

```
document.addEventListener('quizKitAddToCart', function (e) { 
  // e.detail - contains an array of product items that will be added to cart.
}, false);
```

5. **"*****quizKitAddToCartSuccess*****"** event. This event fires right after items are added to cart. You can use this event to create a direct connection with your Theme's Ajax (Slide out) cart.

Add the code below to catch this event:

```
document.addEventListener('quizKitAddToCartSuccess', function (e) {
  // code for refreshing your Ajax cart and opening it here
}, false)
```


# Making your quiz full-width

You can adjust the width of your quiz so that it looks better on your store's page.

If you published your quiz and it doesn't look how it should on your page, you can add code to increase the width to full-width.

## In this section

* [Applying a new template to your quizzes](#applying-a-new-template-to-your-quizzes)
  * [Part 1: Create a new page template](#part-1-create-a-new-page-template)
  * [Part 2: Apply the new template to a page](#part-2-apply-the-new-template-to-a-page)

***

## **Applying a new template to your quizzes**

There are two parts to this tutorial. In Part 1 you create a template, and in Part 2 you apply the template to your quiz page.

### **Part 1: Create a new page template**

After you have published your quiz on any page, then you need to add a page template to your theme.

**Steps:**

1. From the Shopify admin, click **Online Store**.
2. Click the ellipses (`...`), then click **Edit code**.
3. From the theme code editor under **templates**, click + **Add a new template**.
4. Enter a file name for this template, like `page.quiz-kit.liquid`.&#x20;
5. Copy the following code: `{{ page.content }}`.
6. Click on your new template and paste the code you copied at the top of it.
7. Click **Save**.

### Part 2: Apply the new template to a page

After adding the new template to your theme, you need to switch your quiz page's template to the new one.

1. Navigate to the page that your quiz is on in your **Online Store > Pages** section.
2. Under the **Online store** section, under **Theme template**, click the drop-down and select your newly created template.
3. Click **Save**.

You only need to create this template once, and then you can apply it to all your quizzes by repeating the steps in [Part 2](#part-2-apply-the-new-template-to-a-page).


# Using submission data

When a customer completes a quiz with an email address, the email address is added to the [Shopify customers list](https://help.shopify.com/en/manual/customers/manage-customers) and the email marketing status is set to `Subscribed`. These customers have the tag `Quiz Kit app subscriber` so that you can easily identify how they were added. You can also [create a customer segment for targeted marketing with apps like Klaviyo](https://help.klaviyo.com/hc/en-us/articles/115005080907-Use-Shopify-Tags-to-Filter-Customers).&#x20;

All customer answers including emails, phone numbers, birthdays, and names are saved in Quiz Kit's [Submissions](/analytics-and-optimization/viewing-submission-data) section under that particular quiz.

### Using the data

You can use the data that you get from quiz submissions in marketing campaigns. You can also use the **Marketing property name** on each question to pass structured data (e.g., `hair_type`) into your email service provider.

For example, if you're a skin care brand, the following table offers suggestions for how to use the data:

<table><thead><tr><th width="199.6875">Channel</th><th>Example use</th></tr></thead><tbody><tr><td><strong>Email</strong></td><td>Send routine reminders based on skin type tag.</td></tr><tr><td><strong>SMS</strong></td><td>Text “Your personalized bundle is back in stock” to dry-skin segment.</td></tr><tr><td><strong>On-site</strong></td><td>Show dynamic banner: “Hey {{first_name}}, ready for your fall routine?”</td></tr><tr><td><strong>Ads</strong></td><td>Build look-alike audiences from quiz leads.</td></tr></tbody></table>

{% hint style="success" %}
**Tip:**&#x20;

You can also use [personalized customer data](/advanced-settings/personalizing-your-quiz) that you collect from the quiz in susquent questions and answers.
{% endhint %}


# Viewing submission data

Learn about the Submissions page and how to export your quiz submission data.

On the **Submissions** page, you can view each submitted quiz along with the answers selected for each question. Even if a customer doesn't enter their email address, their responses still show up on the **Submissions** page.

You can choose to display a specific quiz and date range, and export all of the submissions.

## In this section

* [Selecting a quiz and timeframe](#selecting-a-quiz-and-timeframe)
  * [Exporting your quiz submission data](#exporting-your-submissions-data)

***

## Selecting a quiz and timeframe

**Steps**:

1. From the Quiz Kit app menu, click **Submissions**.
2. On the **Submissions** page, click on the name of the quiz that auto-populates in the table.
3. From the drop-down menu, click the quiz name that you want to view data for.
4. Click the date-picker box that auto-populates with data from **Today**.
5. Select the timeframe of data you want to display. You can use the preset options on the left of the dialog box or select your own start and end date in the calendar.

### Exporting your quiz submission data

If you have a quiz and timeframe selected that has data for it, you can export the data by clicking **Export**.

Clicking **Export** automatically triggers a download of an .xlsx file. You can open it in a spreadsheet program that supports .xlsx files like Microsoft Excel, Google Sheets, or Apple Numbers.


# Analytics and tracking

Learn about setting up tracking and analytics, and how Quiz Kit reports the data.

## **In this section**

* [Tracking setup](/building-a-quiz/integrations/analytics-and-tracking)
* [Quiz analytics](/analytics-and-optimization/analytics-and-tracking/quiz-analytics)
* [Dashboard and reporting](/analytics-and-optimization/analytics-and-tracking/dashboard-and-reporting)


# Tracking setup

Learn about tracking conversion and user behavior from your quizzes.

You can use Google Analytics and Meta Pixel to track how customers interact with your quiz. This includes actions like starting the quiz, completing it, subscribing, or adding products to cart.

Tracking these events helps you monitor performance and gather data for advertising or analysis.

To learn more about which tracking pixels we integrate with, visit the following pages:

* [Meta Pixel (Facebook Pixel)](/building-a-quiz/integrations/analytics-and-tracking/meta-pixel-facebook-pixel)
* [Google Analytics](/building-a-quiz/integrations/analytics-and-tracking/google-analytics)
* [Additional marketing data](/building-a-quiz/integrations/analytics-and-tracking/additional-marketing-data)


# Quiz analytics

Learn about the quiz analytics section and quiz submission data.

You can access a comprehensive overview of customers' answers to all quiz questions, offering valuable data for future recommendations.

You can also learn more about [revenue calculation, conversion rates](/analytics-and-optimization/analytics-and-tracking/dashboard-and-reporting), and [A/B testing](/analytics-and-optimization/a-b-testing-your-quiz) setup.

## In this section

* [Accessing quiz analytics](#accessing-quiz-analytics)
* [Accessing quiz submission data](#accessing-quiz-submission-data)
* [Setting up quiz email notifications](#setting-up-quiz-email-notifications)

## **Accessing quiz analytics**

You can access an overview of the analytics for a given quiz and timeframe.

**Steps:**

1. From the Quiz Kit app menu, click **Analytics**.
2. Choose a quiz from the drop-down list.
3. Set your desired date range.

The overview page displays the following insights:

* Revenue
* Conversion rate
* Quiz sessions
* Quiz completions
* Emails collected
* Number of products added to the cart
* Most viewed products
* The three most frequently selected answers per question
* Most abandoned questions

{% hint style="warning" %}
**Note:** The data on your Quiz Kit analytics dashboard displays according to the timezone that you're in when viewing it. This may differ from your Shopify analytics, as the timezone for orders is manually set in the Shopify settings. [Learn more about timezones.](/faqs-and-support/frequently-asked-questions#why-are-my-quiz-kit-analytics-different-than-my-shopify-analytics)
{% endhint %}

## **Accessing quiz submission data**

You can access a detailed view of each submission in a given quiz and timeframe.

**Steps:**

1. From the Quiz Kit app menu, click **Submissions**.
2. Choose a quiz from the drop-down list.
3. Set your desired date range.

The submissions table includes:

* customers' email address/phone number when provided
* quiz questions with answers
* recommended product(s) based on responses&#x20;
* result name

Each question is presented in a separate row.

To download the table with customer answers, click the **Export**, and an .xlsx file downloads. [Learn more about quiz submission data](/analytics-and-optimization/viewing-submission-data).

***

## **Setting up quiz email notifications**

You can set up email notifications that trigger when a customer completes a quiz. Emails contain quiz answers, customer contact information, and quiz results.&#x20;

**Steps:**

1. From the quiz builder menu, click **Settings**.
2. On the default **Quiz** tab, check **Send automated email with each Quiz submission**.&#x20;
3. Ensure the email address under **Submission notifications email** is the one you want emails to be sent to, or update it appropriately.
4. Click **Save**.


# URL redirect analytics

If you set up URL redirects for any of your quiz results, complete this additional step to associate the appropriate product(s) with sales data.

If you set up your quiz to redirect users to a URL after completing the quiz, then you also need to associate products with the redirect to accurately attribute those product sales to your quiz.

**Steps**:

1. From the quiz builder, click **Results**.
2. Click the **Result**, then the **Outcome**, that you have the redirect set up for.
3. Click **Select products**.
4. Check the products that you want to be associated with the **Outcome**.
5. Click **Save and close**.

{% hint style="warning" %}
Skipping this step results in no products being tracked for that quiz result.
{% endhint %}

{% embed url="<https://www.loom.com/share/632b2180b1034c70b2b3cde5b44657b0?sid=c2aa774a-1c4b-4e5f-95e2-ae51f4704632>" %}


# Dashboard and reporting

Learn about analytics and how you can use metrics to monitor your quiz's performance.

Quiz Kit's analytics metrics help you understand how your quizzes are performing overall, and how successful they are at achieving your goals.

Quiz Kit collects event data from a customer's first click on your quiz to the time an order is placed or abandoned.&#x20;

Read the [analytics metrics definitions](#analytics-metrics-definitions) to understand what each metric means within your Analytics page.

## In this section

* [Understanding Quiz Kit's reporting](#understanding-quiz-kits-reporting)
  * [Revenue calculation](#revenue-calculation)
  * [Conversion rate calculation](#conversion-rate-calculation)
* [Analytics metrics definitions](#analytics-metrics-definitions)

***

## Understanding Quiz Kit's reporting

With some third-party apps on Shopify, you might notice a discrepancy between your revenue reported by Shopify, and revenue reported by third-party apps, as they often use different technology to determine what's considered "revenue".

Quiz Kit uses Shopify's technology (Web Pixels API) to attribute revenue to Quiz Kit as accurately as possible. Quiz Kit also uses a reasonable attribution window of 10 days. This means if a customer places an order from their quiz results page within 10 days of completion, then it's counted as a conversion.

{% hint style="warning" %}
URL redirects that are set up as Results require one additional step in order to be tracked for conversions. [Learn more about setting up this step](/analytics-and-optimization/analytics-and-tracking/quiz-analytics/url-redirect-analytics).
{% endhint %}

### Revenue calculation

{% hint style="info" %}
Your **Analytics** page overview is controlled by the quiz, and the date range that you select at the top of the page. The comparison is based on the date range selected. For example, if you choose to view the last 30 days of data, it's compared to the previous 30 days of data.
{% endhint %}

Quiz Kit measures order conversion by tracking two key events: **direct revenue**, and **add-to-cart activity**.

1. **Direct revenue**: Money earned from completed purchases that came from quiz recommendations. Only actual orders are counted, not just items added to the cart.
2. **Add to cart activity**: This metric is tracked separately to help you understand customer intent and identify potential drop-off points in the buyer journey.

Tracking these metrics helps you:

* Understand actual revenue from completed purchases.
* Monitor "add to cart" actions separately.
* Understand where customers might be dropping off in their buying journey.

{% hint style="info" %}
**Tip**: Test how your conversion rate changes as you adjust your quiz questions and product recommendations. This helps you optimize for better results.
{% endhint %}

### Conversion rate calculation

Conversion rate measures how effectively your quiz results/completions turn into orders. The formula is:

```
Conversion Rate = (Number of Orders / Number of Quiz Completions) × 100
```

**Example**:

* 50 orders from quiz recommendations
* 1,000 total quiz completions
* Conversion rate equation: (50/1000) × 100 = 5%

A 5% conversion rate means that 5% of quiz completions result in orders. This metric can help you benchmark your quiz performance and identify opportunities for optimization.

***

## Analytics metrics definitions

* **Abandonment rate**: The percentage of customers that didn't complete the quiz
* **Add to cart**: The number of clicks on the **Add to cart** button&#x20;
* **Average order value:** The average spend per order from quiz-recommended products within the attribution window.
* **Completions**: The number of times a customer finishes the quiz (ie gets their results)
* **Conversion rate**: The calculation for how effectively your quizzes turn quiz completions into orders
* **Email/SMS captures**: The number of email addresses and phone numbers that were input into the quiz (if it was completed)
* **Engagements**: The number of times a new or returning customer initiates interaction (ie the first click) with your quiz
* **Revenue**: Money earned from customer purchases that directly came from quiz recommendations (attribution window is 10 days from the date of quiz completion)
  * All revenue displays by default
  * You can also filter by manual results or Fallback results to determine which result type is performing best
* **Top answers**: Quiz answers that were selected the most often
* **Top recommendations**: Products that were recommended (on the results page) the most often
* **Total orders**: The number of products placed from the quiz results page, within the attribution window


# A/B testing your quiz

Learn how to set up A/B testing for your quizzes, and how to monitor performance.

A/B testing is a method used to compare two different versions of a webpage or app to determine which one performs better.&#x20;

It involves presenting two versions (A and B) to different segments of your audience and analyzing which version yields better outcomes.&#x20;

With Quiz Kit, your A/B test involves using two different versions of your quiz and then your customers are presented with one of version when they visit the quiz. The quiz they are presented is randomized with a 50/50 chance of either quiz being seen.

## In this section

* [Setting up a new A/B test](#setting-up-a-new-a-b-test)
* [Publishing an A/B test](#publishing-an-a-b-test)
* [Editing an A/B test](#editing-an-a-b-test)
* [A/B test analytics](#a-b-test-analytics)
  * [A/B test metrics](#a-b-test-metrics)

***

## Setting up a new A/B test

A/B testing is a valuable tool in refining and enhancing user experiences based on empirical data and user behaviour analysis.

Using A/B testing helps you assess quiz changes like design modifications or content variations to see which version leads to increased engagement or conversion rates.&#x20;

**Steps**:

1. From the Quiz Kit app menu, click **A/B testing**.
2. In the **Name** text field, enter a test name.&#x20;
3. In the **Quizzes** text field, select two of your quizzes that you want to compare in the test.
4. Click **Create**.

***

## Publishing an A/B test

When you're ready, you need to make the A/B test live to customers.

**Steps:**&#x20;

1. From the A/B testing main page, click **Publish**.
2. Follow the instructions on [publishing](/publish-and-launch/publishing-your-quiz) if you want to add your quiz to another location in your store.

By default, the A/B test quizzes are published on their dedicated page, following the theme you selected earlier.

You also have the same options to publish the A/B test to a section of your store, as you did with your quizzes originally. Learn more about [publishing options](/publish-and-launch/publishing-your-quiz).&#x20;

***

## Editing an  A/B test

After an A/B test has been created and published, you can edit certain settings while the test is ongoing.

**Steps**:

1. From the A/B testing main page, click the ellipsis button (`...`) beside your quiz.
2. Do one of the following:
   1. **Edit name**: You can edit your A/B test's name
   2. **Publish settings**: Review the publication options for your A/B test
   3. **Finish testing**: You can end the A/B test when you're done
   4. **Delete**: Delete the whole A/B test and its analytics.

***

## A/B test analytics

The **View analytics** button provides a snapshot of your test results. It displays the two quizzes that you selected to A/B test, and their key metrics.

Understanding these metrics helps you make informed decisions about which quiz to keep active and which one to unpublish.

### A/B test metrics

* **Engagements**: The number of times a new or returning customer initiates interaction (ie the first click) with your quiz
* **Completions**: The number of times a customer finishes the quiz (ie gets their results)
* **Abandonment**: The percentage of customers that didn't complete the quiz
* **Emails/phones captured**: The number of email addresses and phone numbers that were input into the quiz if completed
* **Revenue conversion rate**: The calculation for how effectively your quizzes turn completions into orders/revenue


# Billing and account

Learn about how the Quiz Kit app is billed to you.

The Quiz Kit app is billed on your regular recurring Shopify invoice, which you can access in your Shopify Admin under **Settings** > **Billing**.&#x20;

## In this section

* [Understanding your plan and billing](#understanding-your-plan-and-billing)
  * [Billing cycle](#billing-cycle)
* [Cancelling and removing Quiz Kit](#cancelling-and-removing-quiz-kit)
  * [Step 1: Uninstall the app and cancel your subscription](#step-1-uninstall-the-app-and-cancel-your-subscription)
  * [Step 2: Remove the app code](#step-2-remove-the-app-code)

***

## Understanding your plan and billing

You can find information about the current plan or plan tier that you're on in your Quiz Kit app's billing section. From the Quiz Kit app menu, click **Billing**.

Learn more about Quiz Kit's [pricing and plans](/getting-started/pricing-and-plans) and tiered pricing per quiz engagement.&#x20;

### Billing cycle

The Quiz Kit app is billed through Shopify. You can [learn more about how Shopify bills for app charges](https://help.shopify.com/en/manual/your-account/manage-billing/billing-charges/types-of-charges/third-party-charges/app-charges).

***

## Cancelling your subscription and removing Quiz Kit

If you decide that you want to cancel your Quiz Kit subscription and remove the app, you need to follow the correct steps to fully uninstall the app and avoid any future issue.

Simply deleting the Quiz Kit app leaves residual code in your Shopify theme that can cause problems down the line such as performance issues and complicating future debugging and code maintenance.

### Step 1: Uninstall the app and cancel your subscription

Cancelling your app subscription is as simple as uninstalling the app from your Shopify admin. However, after you've removed the app, continue with the steps to remove remaining app code.

{% hint style="warning" %}
**Caution:**&#x20;

It's critical to understand that app deletion results in the non-functionality of your quiz. To prevent issues, hide the relevant pages or sections of your theme before initiating this process.
{% endhint %}

**Steps:**

1. From the Quiz Kit app dashboard, click the ellipses (**`...`**) on the top-right hand of the page.
2. From the drop-down menu, click **Uninstall**.
3. Review the information, then click the drop-down to select a reason for uninstalling.
4. Share any feedback that you want, and then click **Uninstall**.

### Step 2: Remove the app code

After uninstalling the app in step 1, the app's code is eliminated from all themes, with the exception of the home page section. You need to hide this section separately.

**Steps:**

1. From your Shopify admin, click **Online Store**.
2. Find your theme and click **Customize**.
3. From the theme editor menu under **Apps**, click the Quiz Kit section block.
4. Click **Remove block**.
5. Click **Save**.

{% hint style="info" %}
We only store your Quiz Kit data for 3 days after you unsubscribe. If you need to keep your data past the 3 days, please reach out to support at: <support@quizkitapp.com>
{% endhint %}


# Quiz Kit interface

Learn about the Quiz Kit app interface, and what each section is used for.

The Quiz Kit app interface is split into the following sections. Click on each section to learn more:

* [My Quizzes](/account-and-settings/quiz-kit-interface/my-quizzes)
* [A/B testing](/account-and-settings/quiz-kit-interface/a-b-testing)
* [Analytics](/account-and-settings/quiz-kit-interface/analytics)
* [Submissions](/account-and-settings/quiz-kit-interface/submissions)
* [Integrations](/account-and-settings/quiz-kit-interface/integrations)
* [Billing](/account-and-settings/quiz-kit-interface/billing)
* [Support](/account-and-settings/quiz-kit-interface/support)


# My Quizzes

Learn about the My Quizzes section of the Quiz Kit app.

The My Quizzes page is the main page of the Quiz Kit app and acts as a dashboard or overview of the most current and relevant content for your quizzes.

The dashboard is split into the following sections:

* [Quiz analytics](#quiz-analytics)
* [Quiz library](#quiz-library)

Additionally, you can initiate the creation of a new quiz directly from this section by clicking the **Create a new quiz** button located in the top right corner.

***

## Quiz analytics

The **Quiz analytics** section gives you a default overview of the last 30 days of data for all your quizzes. You can adjust the drop-downs to choose a specific quiz to look at, and/or a different timeframe.

The analytics displayed are Engagements, Add to cart, Revenue, and Email/SMS captures.

You can [read more about your quiz analytics](/analytics-and-optimization/analytics-and-tracking/quiz-analytics).

## Quiz library

The **Quiz library** section provides an overview of all your quizzes and the following information for each of them: last save timestamp, whether they are in a published or draft state, engagement count, revenue earned, number of Email/SMS captures, and quick links to their analytics page or to customize.&#x20;


# A/B testing

Learn about how A/B testing can help you finesse your quiz and grow your business.

A/B testing is a method used to compare two different versions of a webpage or app to determine which one performs better.&#x20;

It involves presenting two versions (A and B) to different segments of your audience and analyzing which version yields better outcomes.&#x20;

With Quiz Kit, your A/B test involves using two different versions of your quiz and then your customers are presented with one of version when they visit the quiz. The quiz they are presented is randomized with a 50/50 chance of either quiz being seen.

Learn more about how to [set up and monitor A/B testing for your quiz](/analytics-and-optimization/a-b-testing-your-quiz).


# Analytics

Learn about how you can track your quiz metrics to understand how your quizzes are performing.

Quiz Kit's analytics metrics help you understand how your quizzes are performing overall, and how successful they are at achieving your goals.

Quiz Kit collects event data from a customer's first click on your quiz to the time an order is placed or abandoned.&#x20;

Read the [analytics metrics definitions](/analytics-and-optimization/analytics-and-tracking/dashboard-and-reporting#analytics-metrics-definitions) to understand what each metric means within your Analytics page.

Learn more about [data and analytics](/analytics-and-optimization/analytics-and-tracking/quiz-analytics), and your [analytics metrics](/analytics-and-optimization/analytics-and-tracking/dashboard-and-reporting).


# Submissions

Learn about the quiz Submissions page and how to export your data.

On the **Submissions** page, you can view each submitted quiz along with the answers selected for each question. Even if a customer doesn't enter their email address, their responses still show up on the **Submissions** page.

You can choose to display a specific quiz and date range, and export all of the submissions.

Learn more about [Submissions page and how to export submissions data](/analytics-and-optimization/viewing-submission-data).


# Integrations

Set up Quiz Kit to integrate with the apps and features that are important to your business.

You can set Quiz Kit up to integrate with many of the marketing apps and native Shopify features that you use for your store. \
\
Learn more about the [apps and Shopify features that can integrate with Quiz Kit.](/building-a-quiz/integrations)


# Billing

Learn about the Billing section in the Quiz Kit app.

The billing page displays your current plan tier, and allows you to use the slider to determine the number of engagements that will bring you to the next plan tier.

Learn more about[ billing and account management](/account-and-settings/billing-and-account).


# Support

Use Quiz Kit's Support page to contact our support team if you need any help.

Quiz Kit support is here to help you if you have any questions about our app.

From the Quiz Kit app menu, under **Support**, you'll find a direct link to our [Help Center](https://support.quizkitapp.com/), as well as a link to send us an email: [`quizkit@presidiocreative.com`](mailto:quizkit@presidiocreative.com)*.*

You can also contact us via the chat widget that's at the bottom right-hand corner of the screen when you're in the Quiz Kit app.&#x20;


# Quiz Builder


# Quiz

Learn about the Quiz page of the quiz editor and its options.

The quiz editor has several sections to familiarize yourself with when building your quiz. The main sections are the [Introduction](/account-and-settings/quiz-builder/quiz/introduction) page, the [Questions Content](/account-and-settings/quiz-builder/quiz/questions), Answers, and the [Additional page](/account-and-settings/quiz-builder/quiz/additional-page-types) types.&#x20;

When building or editing a quiz, content is displayed in three columns: the quiz content on the left, a real-time preview of the quiz in the middle, and the edits or actions you can perform on the right.&#x20;


# Introduction

Get an overview of the introduction page of the quiz editor.

The introduction is an optional, initial page of your quiz. If enabled, it's the first page your customers encounter in your quiz

{% hint style="info" %}
**Note**

You can choose to hide the introduction page.&#x20;
{% endhint %}

On the introduction page, you can modify the content alignment, background color, and add custom JavaScript if you want to use custom code in your quiz.

You can also edit the following sections:

* **Heading**:  Create a title for your quiz.
* **Subheading**: Add a subheading for more nuanced messaging.
* **Image**: Add a main image for your quiz.
* **Button**: Include a call-to-action to prompt customers to take your quiz.




---

[Next Page](/llms-full.txt/1)

