A guided quiz that matches customers to products by tag, with an optional email capture on the results.
The customer answers a short series of questions, one card at a time. Every answer they pick carries a product tag, and when the quiz ends the theme scores the products in your source collection by how many of the chosen tags each one carries. The top three matches appear as product cards.
How the matching works
- Tag your products in the Shopify admin with the qualities you want to match on (e.g.
sleep,calm,capsule). - Set the Source collection. Products are matched from this collection by their tags; the first 50 products are considered, and products without tags are ignored.
- Build your questions and answers as blocks, giving each answer a Product tag.
- As the customer answers, each chosen tag scores a point for every product carrying it. Matching ignores capitalization.
If nothing scores, the Fallback stands in, so there is always a result. Without a fallback set, the collection's first products are shown instead.
The section only appears on your storefront once it's workable (a source collection with tagged products, plus at least one question). In the theme editor it always renders, with warnings for anything missing, so you can build it up in place.
Content
- Source collection - the collection products are matched from.
- Heading, Heading tag, and Text
Step counter
- Badge text - rotates around the step counter (e.g. "Find your match · Find your match ·"). Leave blank to hide the badge.
- Badge color scheme
Results
| Setting | What it does |
|---|---|
| Results heading | Shown above the matched products. |
| Fallback | Product or Collection. Shown when no products match the chosen answers, and offered under the results. |
| Fallback product / Fallback collection | The product card, or a button linking to the collection. |
| Fallback text | A short line introducing the fallback. |
Email capture
- Enable email capture - shows a signup with the results. Signups create Shopify customer records tagged with the chosen answers. The matches email itself is not sent by the theme: set it up in your email marketing provider, triggered by those tags.
- Email text - shown above the signup form.
- Custom customer tag - added to customers who sign up through the finder, along with their chosen answer tags.
Styling
- Color scheme
- Quiz card style - Standard, Filled, or Outlined. Standard sits the questions directly on the section background, Filled paints the card with its own Quiz card color scheme, and Outlined draws a border.
- Content style
This section also uses the standard Framing text settings and Advanced styling overrides described in Theme settings.
Blocks
Questions and answers are nested blocks:
- Question - one quiz step, with a Prompt and an optional Image. Add up to 4.
- Answer - added inside a question. Each has a Label the customer reads and the Product tag it contributes to matching when chosen. Picking an answer advances to the next step automatically; a Back button covers corrections.