Getting started

Publish your quiz on your store

Make your quiz Active, choose whether it shows as a popup, a section or a button in your theme, and test it on your storefront.

6 min read·Updated October 20, 2026·All plans

In the appSalesQ/Quizzes/Edit/Publish

In this guide

  1. 01Make a quiz Active so your store can show it
  2. 02Show it as a popup, inside a page, or behind a button
  3. 03Choose the pages it appears on and when it opens
  4. 04Test the quiz on your storefront like a shopper

Before you start

Publishing takes two parts. First you make the quiz Active in the app. Then you choose how it appears in your theme: as a popup, as a section inside a page, or as a button that opens the popup.

Make the quiz Active

  1. 1

    Publish from the editor

    Open the quiz and click Publish in the top-right corner. The button changes to Published and you'll see Quiz activated.

    The editor top bar with the Active switch on and the Published button
  2. 2

    Or use the switch or the list

    You can also turn on the Active switch at the top left of the editor. On the Quizzes page, clicking a quiz's Draft status changes it to Active, and clicking Active changes it back.

    The Quizzes page: Foundation Finder Active, other quizzes Draft, with New quiz and Import

To take a quiz off your store, switch it to InActive in the editor. You'll see Quiz set to draft. Draft quizzes never appear on your storefront.

Choose how it appears

PlacementName in the theme editorBest for
PopupAi Sales Quiz under App embedsOpening the quiz on chosen page types, after a delay, on scroll or on exit.
Section in a pageAi Sales Quiz app blockA quiz page, or a quiz inside your home or product page.
ButtonAi Sales Quiz — Button app blockA "Take the quiz" button anywhere in your theme that opens the popup.

You can use more than one placement for the same quiz.

Show it as a popup

  1. 1

    Open the theme editor

    In Shopify admin, go to Online Store → Themes and click Customize. Or, on the app's Home, click Open theme editor on the Enable the theme app extension card.

    Get started cards on Home, with Open theme editor on the Enable the theme app extension card
  2. 2

    Switch on the embed

    Open App embeds and turn on Ai Sales Quiz.

    Shopify theme editor, App embeds: Ai Sales Quiz switched on, with the quiz opening in the store preview
  3. 3

    Allow the right pages

    Under Page targeting, tick the page types the popup may use. Home page, Product pages and Collection pages are on by default. Tick Show on all pages to allow every page.

  4. 4

    Save the theme

    Click Save in the top-right corner of the theme editor.

  5. 5

    Set pages and timing in the app

    Back in the quiz editor, open the Popup tab. Under Show this quiz on, choose the pages, and under When to show, choose when it opens. New quizzes open After delay, 22 seconds after the page loads.

    The Popup tab, headed Widget behavior: Show this quiz on, When to show and Delay

Add it inside a page

  1. 1

    Open the page template

    In the theme editor, use the page selector at the top to open the template you want, for example a page, a product or the home page.

  2. 2

    Add the app block

    Where the quiz should go, click Add section, open the Apps tab and choose Ai Sales Quiz. If your theme lets you add app blocks inside a section, you can also click Add block there and pick it under Apps.

    Theme editor, Add section, Apps: Ai Sales Quiz from Ai Sales Quiz Builder
  3. 3

    Name the quiz

    In Quiz, type the quiz name exactly as it appears in the app. If you leave it empty, the block shows the quiz targeted to that page.

  4. 4

    Save the theme

    Click Save. The quiz now shows inside the page, not as a popup.

The section block works on its own, even if the Ai Sales Quiz app embed is off.

Add a quiz button

  1. 1

    Add the button block

    In the theme editor, click Add section, open the Apps tab and choose Ai Sales Quiz — Button. In themes that allow app blocks inside sections, Add block works too.

    Theme editor, Add section, Apps: Ai Sales Quiz — Button
  2. 2

    Set the text and quiz

    Change Button text if you like (the default is Take the quiz) and type the quiz name in Quiz.

  3. 3

    Style it

    Adjust Background color, Text color, Corner radius, Font size, Alignment and Full width so it fits your theme.

  4. 4

    Save the theme

    Click Save. Clicking the button opens the quiz as a popup, even on pages where the popup doesn't open by itself.

Test it on your storefront

  1. 1

    Open your store in a private window

    Use a private or incognito browser window, and go to a page the popup is allowed on.

  2. 2

    Wait for the popup

    With the default settings it opens after 22 seconds. To test faster, set When to show to Immediately in the Popup tab, save, and change it back later.

  3. 3

    Finish the quiz

    Answer the questions and enter a test email. Check the result page, the products and the discount code, then look for your test entry under Subscribers in the app.

    The result page on the storefront: confetti, the recommended foundation and Add to cart

Video tutorials

Watch the series in order, or jump to the one you need.

  1. 011:32How to Install a Shopify Quiz App: AI Sales Quiz Builder Setup & Tour
  2. 021:38How to Create a Product Recommendation Quiz on Shopify (Step by Step)
  3. 031:44Shopify Quiz Templates: Build a Product Quiz in Minutes
  4. 041:48How to Add a Quiz to Your Shopify Store (Publish & Embed)Now playing
  5. 051:56Shopify Quiz Popup: Triggers, Timing & Page Targeting
  6. 061:44Shopify Quiz Logic & Branching: Send Shoppers to the Right Product
  7. 071:42Shopify Quiz Discount Codes: Unique Codes That Convert
  8. 081:44Shopify Email Marketing: Create a Quiz Follow-Up Email
  9. 091:36Shopify Email Templates for Quiz Follow-Ups (Ready to Use)
  10. 101:51Shopify Email Builder Tutorial: Drag-and-Drop Blocks
  11. 111:49Personalize Shopify Emails With Quiz Answers (Merge Tags)
  12. 121:32Shopify Email Automation: Quiz Follow-Up Flow Step by Step
  13. 131:29Manage Shopify Email Automations: Pause, Resume & Edit Flows
  14. 141:41Shopify Email Sending Limits Explained (Quiz Emails)
  15. 151:31Send Shopify Emails From Your Own SMTP Server
  16. 161:43Shopify Email Consent & Unsubscribe Link Explained
  17. 171:46Shopify Quiz Subscribers: Search, Filter & View Profiles
  18. 181:45Shopify Quiz Analytics: Track Revenue, Conversions & Emails
  19. 191:44Shopify Abandoned Cart Tracking for Quiz Shoppers
  20. 201:42Klaviyo Shopify Integration: Send Quiz Subscribers to Klaviyo
  21. 211:43Best Shopify Quiz App Pricing: AI Sales Quiz Builder Plans Compared

Learn more

Next stepEditor tourWhat each part of the quiz editor does: the top bar, the six tabs, the left panel and the canvas.

Related articles

Was this page helpful?

Create your first quiz