Build a scored quiz that recommends a product

A scored quiz asks a few multiple-choice questions, gives each answer points, and then shows the products that fit the answers your customer chose. This guide builds a simple “find your match” quiz end to end: a couple of quiz questions, an email capture, and a results page that recommends products based on the points your customer collected.

The fastest way to start is the Product Recommendation Quiz template. It comes pre-built as a 7-step funnel with scoring, email capture, a loading screen, and a results step, with scoring categories already wired up. You add your own questions and products on top. If you’d rather build from scratch, the steps below show every piece.

How scoring works

Scoring is built around two ideas: categories and weights.

A category is a bucket, like dry_skin or oily_skin. You name your own categories.
A weight is the number of points an answer adds to a category when a customer picks it.

As your customer answers questions, their points add up. Each category keeps its own running total. At the results step, every product you add is matched to a category and a score range. A product shows when the customer’s total for that category falls inside the range you set.

There is no single “winning answer.” Each category builds up on its own, and products appear based on the ranges you give them. You decide which products show by setting those ranges, not by picking one top category.

Steps

If you’re building from scratch, open the container settings and set Display mode to Standalone page (own URL). Quiz Question, Loading Screen, and Results steps, and the Product Results section, only appear once the popup is in this mode. (The Product Recommendation Quiz template is already set to this mode, so you can skip this step when you start from the template.)

1. Add your quiz questions

In the editor, click + Add Step and choose Quiz Question (described as “Multiple choice with scoring and routing”). Add the question text and your answer options.

Use Quiz Question steps for anything you want to score. The Survey step looks similar but is labeled “Multiple choice question (no scoring),” so it will not add points.

2. Score each answer

Select an answer, then open the Scoring panel. Fill in both fields:

Score weight: how many points this answer adds (for example, 3).
Score category: the bucket it adds to (for example, dry_skin).

You must set both fields. An answer with only a weight, or only a category, adds nothing. The helper text sums it up: higher weight means a stronger match, and customers accumulate scores across steps.

Repeat for every answer you want to score. A strong-fit answer might add 3 points, a partial fit 1, and an unrelated answer might add nothing or point to a different category.

Pick your category names carefully and keep them consistent. You will type the same names again on your products, and they must match exactly, including capitals. dry_skin and Dry_skin are treated as different buckets.

3. Add an email capture (optional)

If you want to collect emails before showing results, add an Email Capture or SMS Capture step. The template includes one already.

4. Build the results step

Click + Add Step and choose Results (“Show product recommendations”). It comes with a heading and a Product Results section (“Product cards from your Shopify store”).

In the Product Results section, add products using the Search products… box or the Your products browse list. These pull straight from your Shopify catalog.

5. Map each product to a score range

For each product you added, open its Score mapping panel and set:

Score category: which bucket this product is matched against (must match a category from step 2, exactly).
Min score and Max score: the range the customer’s total must land in. Both bounds are inclusive, so a total equal to the min or the max still counts.

A product shows only when the customer’s total for its category is between the min and max. Leave a bound blank to skip it. To make a product show to everyone as a safe default, leave its Score category empty; a product with no category always shows.

If you want exactly one product per outcome, give each product a non-overlapping range (for example, one product for 0 to 4, another for 5 to 9). Overlapping ranges mean more than one product can show at once. Products appear in the order you add them.

6. Set the look of the results

Open the Display options panel on the Product Results section to choose Layout (Grid or List), Image aspect ratio, and which details to show, such as Show image, Show price, and Show description. The Button styling panel sets your Add to Cart text and button color.

7. Publish and test

Publish the quiz, then run through it on your store. Pick answers that should land in a known range and confirm the right products appear.

Make it yours

Add a default product. Leave one product’s score category blank so it always shows, even when nothing else matches. Remove it once your ranges cover every outcome, or it will show for everyone.
Show different messages by score. On a section in the results step, open the Show when… panel and pick a Score greater than or Score less than condition. Set a Score category and a Score threshold to reveal a section only when a total is above or below a number. This lets one results step show different copy for different score bands.

Troubleshooting

A product never shows. Check that its Score category is spelled and capitalized exactly like the category on your answers. A mismatch means the product can never match.
The results page says “No recommendations”. No product passed the score filter. Widen a range, or add a fallback product with no score category.
An answer adds no points. Make sure both Score weight and Score category are filled in. One without the other does nothing.
Too many products show at once. Your score ranges overlap. Give each product its own non-overlapping min and max.
You used a Survey step by mistake. Survey steps do not score. Rebuild that question as a Quiz Question step.
Quiz Question or Results steps are missing from the picker. The popup isn’t in Standalone page display mode. Set Display mode to Standalone page (own URL) in the container settings and they’ll appear.