The quiz appears on your storefront through a theme app block. There is no code to write, and removing the block removes the quiz. The storefront only loads published quizzes, so publish first.
- Open the quiz from Quizzes and click Publish quiz.
- Go to Home. In Your quiz setup, click Add the quiz block to your theme. (After publishing, the editor offers the same step as Add the quiz to your theme.)
- Your theme editor opens on the home page with the Product quiz block already added at the bottom, in an Apps section. Drag it higher in the left panel if you want it near the top.
- Click Save at the top right of the theme editor. Until you save, shoppers cannot see the quiz.
- Open your storefront (Visit your storefront) to see it.
The setup checklist on Home marks the block as live after the first real shopper view. Views from bots, results restored from a link, previews and the theme editor's design mode are not counted.
Put it on a different page
Prefer another page? In the theme editor, switch to any page, click Add section → Apps → Product quiz.
Choose which quiz the block shows
- Leave Quiz empty and the block shows your default published quiz: the one it showed before, while that quiz is still published, otherwise the most recently updated published quiz.
- With several published quizzes, pick one explicitly: select the quiz you want in the Quiz setting.
Add quiz images
In the quiz builder, open Theme, then Quiz images to set a logo, background image, and side image. Choose store brand assets, a product image, or paste an HTTPS image URL. The logo defaults to your store brand logo on the storefront; brand assets are not shown in the admin preview.
Choose image opens Shopify Files. On first use, Shopify asks for optional access to read your files. Declining leaves all other image sources available. Choose an image that has finished processing; videos and documents cannot be used.
The quiz saves the chosen image URL, so displaying the image does not need file access. Revoking access later does not remove a saved URL. If the file is deleted in Shopify, its image may stop loading; choose a replacement. Save your quiz to keep the change.
Choose a look in the app
Open your quiz, then Theme. Click one of the 13 look cards, such as Midnight, or Store style. Each card shows a small preview of the quiz in that look, and the builder preview updates immediately. Arrow keys move between cards and apply each one. Looks and built-in fonts are free on every plan.
A look sets a coordinated palette, typography, answer cards, buttons and results. Adjust the colours, font, corners, answer layout and button style below it. These adjustments take priority over the look. Custom CSS is applied last.
A look chosen in the app applies to the quiz block, popup and quiz page. With Store style, the quiz uses your theme’s colours and fonts, and a block or popup can still pick its own Look in the theme editor. The message below the cards tells you which applies. Reset quiz styling returns to the theme editor settings.
Built-in font stacks use fonts installed on each shopper’s device. If the first font is unavailable, a matching fallback is used. They add no font downloads or external service. The five original looks retain their own bundled display fonts, loaded only when used. Font uploads are not available.
Placement settings in the theme editor
Select the Product quiz block to change its settings:
- Heading, Show the subheading and Subheading
- Show a start screen before the first question and Start button label
- Look: Store style uses your theme's buttons and headings, or choose one of 13 styled looks. A look chosen in the app takes priority
- Layout (Banner, Card or Full width), Text alignment, Top padding, Bottom padding and Corner radius
- Accent color and Background color. Leave empty to use your theme's button color. A color that wouldn't be readable on your background is replaced with a readable one.
- Show progress bar during the quiz
- Result cards: Show answer tags on result cards, Show answer match count, Show price on result cards, Primary action on result cards (Add to cart or View product) and Products shown at first. Show more picks reveals another set of this size, up to 24 products.
- Remember completed results: Show the last results again in this browser for 30 days. Shoppers can start over.