If you prefer, you can check out this information in video format.
Results page Overview
The Results Page is where customers see their personalized product recommendations after completing your quiz.
Once you’ve finished setting up your questions, answers, and product matching, the next step is customizing the Results Page. You can learn more about matching products to quiz answers by checking out this guide.
At the top of the Results Page, you can customize a Header and Sub-header.
These text fields support property IDs, which means you can personalize the message using information collected during the quiz (for example, a pet’s name or a customer’s goal).
Example: using {{pet_name}} in the Header or Sub-header to personalize the message.
1. Page Layout
Page Layout lets you change the order of the elements on your Results Page, including the headline, product recommendations, buttons, email sign-up, share buttons, and Dynamic Content Blocks.
To change the layout:
Open your quiz in the Quiz Builder and go to Results Page.
In the right-hand menu, expand Page Layout.
Drag an element using the six-dot handle to move it to your preferred position.
To restore the original arrangement, click Reset to the default order.
Publish your quiz to make the changes live.
Content block widths
By default, Dynamic Content Block widths follow the Top Content Blocks Columns and Bottom Content Blocks Columns settings under General Design.
In Page Layout, you can set each content block's Desktop width and Mobile width to Full, 1/2, 1/3, or 1/4. Content blocks next to each other in the list can share a row when their widths fit. For example, two blocks set to 1/2 appear side by side, while three blocks set to 1/3 fill one row. Once you rearrange the sections or customize their widths, these individual settings take priority over the column settings in General Design.
After you change the order in Page Layout, the entire Results Page uses Bottom Section Width from General Design, and Top Section Width no longer applies. Page Layout also controls the position of the Add all to cart button, so its separate position setting no longer applies.
2. Reviews, Cart, Subscriptions
This section controls how reviews, carts, and subscriptions appear on the Results Page.
Reviews
To see the supported review apps, visit the Reviews section on our Integrations page.
To set it up, all you need to do is select your review app from a dropdown.
Cart and Side Cart Drawers
To see the supported cart and side cart drawers, visit the Cart Drawer section on our Integrations page.
Using a side cart lets customers add products without leaving the Results Page when the quiz is displayed inside your store.
Cart behavior and settings
When a cart drawer is selected
When a side cart drawer is selected, the behavior depends on how the quiz is opened.
If the quiz is opened using the in store page URL, embedded in your store using the app block key, or opened in a pop up, the cart drawer opens automatically
If the quiz is opened as a standalone link or is being previewed, the cart drawer cannot open directly
In this case, Lantern uses your settings as a fallback. Use the following configuration for the best experience.
When no cart drawer is selected
If no cart drawer is selected, Lantern uses your theme’s default cart instead. This is the page accessed using mystoreurl.com/cart
In this case, the behavior is the same across all quiz display methods, including in store pages, embedded quizzes, pop ups, standalone links, and Preview mode.
The following settings control what happens after a product is added to cart:
When the option Do not open cart page is enabled, the product is added to cart and nothing else happens
If it is disabled, the cart page opens
When the option If a cart page is opened, open it in a new tab is enabled, the cart page opens in a new tab
If it is disabled, the cart page opens in the same tab.
Subscriptions
To see the supported subscription integrations, visit the Subscription section on our Integrations page.
Each integration works slightly differently, so it’s best to check the specific guide for the integration you’re using.
3. Results Page design
General Design
Headline Design
You can also adjust:
Text alignment
Font size
This helps improve readability and engagement.
Sub-headline Design
4. Customize Results Page buttons
You can customize three main buttons:
Add to Cart adds an individual recommended product to the cart.
Add All to Cart adds all the recommendations currently displayed to the cart.
View More shows additional product matches.
For each button, you can:
Show or hide it
Change the button text
Adjust text alignment
Change text color and background color
You can also fine-tune the design for desktop and mobile, including:
Font size
Border radius
Button width and spacing
Add to Cart Button
To send customers to the product page instead of adding the product to the cart:
Open Results Page → Add to Cart Button.
Turn off Show add to cart.
Publish your quiz.
The button changes to View Details and opens the product's page in your store. You can change the View Details wording with Button text override.
Add All To Cart Button
For Add All to Cart, you can also show the combined price of the recommended products inside the button. This option is off by default. To show the total price in the button:
Open your quiz in the Quiz Builder and go to Results Page.
In the right-hand menu, open Add All To Cart Button.
Tick Show the total price in the button.
Publish your quiz to make the changes live.
The total uses the price and quantity displayed on each product card. It updates when customers change a product's variant, quantity or purchase options, including subscription options.
To let customers choose how many of each product they want, see How to show a quantity selector on the results page.
View More Button
To change how many extra matches are available, go to View More Button → Total Extra Results. The default is 6 and the maximum is 20. This setting is available when Replace is enabled, even if the View more button is hidden. How many results can I display for my quiz?
Change or translate Results Page wording
Use Quiz text in the Quiz Builder to change built-in labels, buttons and messages for one quiz. To update shared wording across quizzes in the same language, use Translations in the Lantern dashboard.
5. ProductDescription
These sections control how products appear on the Results Page and allow you to customize how recommendations are displayed to ensures they align with your customers' needs.
5.1. Show Product Description
This option displays the full product description pulled directly from Shopify under each recommended product.
Please note:
The entire product description will be shown
This can result in uneven layouts if descriptions vary in length
5.2. Show Short Description from Product Metafields
This option lets you display a shorter, customized product description using an existing Shopify product or variant metafield instead of the full product description.
The metafield must be in Shopify's custom namespace, so its full key in Shopify starts with custom.. In Lantern, you enter only the part after custom.. For example, for custom.lantern_description, enter lantern_description.
To enable it, open Product Description in the Results Page settings, turn on Show Short Description from product metafields and enter the metafield key, then publish your quiz.
Please note:
The metafield can be rich text, single-line or multi-line plain text, or a single file.
An image file shows as a picture, an audio file as an audio player that doesn't play on its own, a video as a video player with controls, and any other file, such as a PDF, as a link named after the file that opens in a new tab.
A metafield that holds a list of files, or a JSON metafield, shows nothing on the product card.
Variant metafields use the same key you enter here.
The metafield must already exist in Shopify and contain the description you want to display.
Remember to publish your quiz for the changes to appear on the Results Page.
For full setup steps, including how to create product and variant metafields in Shopify, see Add a short description using product metafields.
6. Product Recommendations
6.1. Show Sold Out Products
This setting allows sold-out products to appear in quiz results.
In most cases, we do not recommend enabling this, as showing unavailable products can reduce conversions and frustrate customers.
6.2. The Hide Default Recommendations
This option hides the default product recommendations.
It’s mainly used when you want to show results only using Dynamic Content Blocks, for example:
Skincare routines
Step-based recommendations
Structured result layout
Checkout this article to learn more about setting up and using Dynamic Content Blocks.
You can also create score-based recommendations using Dynamic Content Blocks.
6.3. Total Product Recommendations
This setting controls how many products are shown on the Results Page.
You can display up to 10 products
Data shows that 3 products often work best to avoid decision fatigue
You can also set:
Products per row on desktop
Products per row on mobile
6.4 Let shoppers replace a recommended product
The Replace link lets shoppers swap a recommended product for the next best match without retaking the quiz.
In Quiz Builder → Results Page, open Product Recommendations.
Tick Let quiz takers replace a product - show a Replace link under each one.
Publish your quiz.
The setting is off by default.
How replacements work
Replace appears below Add to cart on the main product recommendations when another matched product is available. The next best match takes the same spot, and the product the shopper replaced goes to the back of the queue. Products in Dynamic Content Blocks don’t have a Replace link.
Replacements come from the same pool of extra matches as View more.
Add All to Cart adds the products currently displayed, including replacements. If the button shows a total, it updates after each swap.
Swaps apply to the current visit. Returning shoppers see the original recommendations, and Reporting, emails and integrations that receive recommendations use the original products.
6.5. Match Score Threshold and Total Weight Threshold
The Match Score Threshold lets you show only products that meet a minimum match percentage. For example:
Setting the threshold to 80% will only show products that score at least 80% of the total possible score.
If you use custom answer weights, the Total Weight Threshold works the same way, but uses raw point values instead. To learn more about custom answer weights, check out this article.
6.6. Match Score Format
This setting controls how match scores are shown when customers hover over the info icon on a product.
You can choose to display scores as:
A percentage (for example, 80%)
A fraction (for example, 8/10)
Hidden entirely
6.7. Sorting Priority
With default answer weights, products that match more of the customer’s answers rank higher. When several products are tied, for example because they have the same match score, Sorting Priority decides their order.
If you customize answer weights to give certain answers more influence, this can change the default order, so a product with a lower match score can rank higher. To learn more, see What are answer weights and how they affect your quiz results.
You can sort by:
Lowest price
Highest price
Alphabetical order
Random order
Best selling (units sold, last 60 days)
Newest (product creation date)
This helps you control the order of products that are tied.
Best selling (units sold, last 60 days) shows the products your store has sold the most units of in the last 60 days first.
Newest (product creation date) sorts products by the date they were created.
To learn more about sorting products that have the same match score, see How can I sort quiz results? and Match Score: Thresholds, Product Sorting and Exclusions.
6.8. Show Match Block Above Add To Cart
This option shows a short explanation above the Add to Cart button, explaining why the product was recommended.
It helps:
Build trust
Increase confidence in the recommendations
Show the value of the quiz results
6.9. Show Quantity Selector
Enable this option to let customers choose the quantity they want before adding a recommended product to their cart.
For more details on how to show a quantity selector on the results page, refer to our help article.
6.10. Default products when nothing matches
If none of a customer's answers match a product, you can show fallback recommendations instead of the No results message. To choose them, go to Products → When nothing matches → Default products and use Add Products, Add Variants or Add Collections.
To learn how to set them up, see Product Matching. To learn what else can reduce the number of products shown, see Match Score: Thresholds, Product Sorting and Exclusions.
7. URLs
This section lets you control how quiz takers move through your store after they finish the quiz, and how links behave on the Results Page.
7.1. Return to results page URL automatically
This option is useful for returning visitors.
If someone has already taken the quiz before, enabling this setting will:
Take them directly back to their previous Results Page
Give them the option to retake the quiz (if Start Over is enabled)
This helps create a smoother experience for repeat visitors.
7.2. Show Start Over
This option allows quiz takers to restart the quiz from the beginning, even after they’ve reached the Results Page.
7.3. Show Go Back
This option adds a Go Back button to the Results Page. It takes quiz takers back to the last question they answered, with their previous answers kept, so they can change their answer and get new results without retaking the whole quiz.
Go Back only returns quiz takers to the last question they answered. It is also separate from Start Over, which restarts the quiz from the beginning.
It is off by default.
Please note:
Going back counts as a new quiz taker, the same as Start Over. It appears as a second session in Reporting and counts toward your plan's quiz takers.
When the quiz taker finishes again, the completion is sent to your connected tools again. Email tools such as Klaviyo update the same contact with the new answers, while a Shopify Flow trigger, a webhook, a Zap or a Google Sheets row runs a second time.
7.4. Open Links in New Tab
When enabled, product links and other results page links will open in a new browser tab.
This allows customers to explore products without losing their place in the quiz results.
7.5. Use URL Tracking Parameters
This setting lets you add UTM parameters to your quiz and product links for tracking performance in tools like Google Analytics. For more information on setting up UTM parameters, refer to our help article.
If a customer arrives at your store through an ad with UTM parameters or an ad click ID, such as gclid or fbclid, Lantern carries those original parameters through to product links instead. The UTM parameters you set here are not added alongside them. Existing ad parameters are carried through even when this setting is turned off.
Below this option you'll find additional URL options:
Instead of showing the Results Page, you can redirect users to a specific URL after completing the quiz
Set a custom URL for the View More button
Provide a fallback URL when no results are found
These options are useful for handling edge cases and keeping the customer journey smooth.
To send quiz takers to a page of your choice instead of loading more results, paste the address in When clicking on the View More button, redirect to this URL. If the button doesn't redirect, try the following:
Check the URL for spaces.
Make sure it's a full, valid address.
If your quiz is embedded and the redirect doesn't open, tick Open links in new tab.
8. Order & Customer Tags
This section lets you control whether quiz completions are sent to Shopify Flow, as well as manage order and customer tags.
8.1. Shopify Flow
Send quiz completions to Shopify Flow controls whether quiz completions from this quiz are sent to Shopify Flow.
This setting is enabled by default. Turn it off if you don’t use Shopify Flow or don’t want quiz completions from this quiz sent to Shopify.
To learn more about using Lantern with Shopify Flow, see our Shopify Flow Integration guide.
8.2. Order Tags
When Enable Order Tagging is turned on, Lantern will add a tag to orders placed after quiz interaction. This includes orders from customers who answered at least one quiz question but didn't reach the Results Page.
The tag name is fully customizable per quiz
This makes it easier to track quiz-driven orders
To learn how tagged orders compare with the orders in Lantern's reporting, see Why your Lantern Quiz order tag count is different from Lantern's Orders.
8.3. Customer Tags
When Enable Customer Tagging is enabled, customers who completed the quiz and provide their email address will be tagged automatically.
You can customize the tag name
Customer tags can include an answer or URL parameter, for example
{{ skin_type }}This helps with segmentation and follow-ups
8.4. Create Customer in Shopify
This option automatically creates or updates an existing Shopify customer profile for anyone that completes the quiz and provides their email address.
This helps:
Keep customer records organized
Make future marketing and support easier
8.5. Enable Shopify Double Opt-In
This setting helps you follow GDPR and local marketing consent rules. When enabled:
Customers must actively reconfirm their marketing consent via email
You are responsible for ensuring this fits your legal requirements
To learn more about adding customers to Shopify using the Lantern quiz, visit our comprehensive help article.
8.6. URL Parameters
Enter the names of link parameters in Save these URL parameters (for example credituser, affiliate) to save their values as answers once the customer answers the first question. To learn more, see Shopify Customers.
9. Email Sign-up
You can also let customers see their product recommendations first, then optionally provide their email address directly on the Results Page. Customers can ignore the form and still shop their results.
To enable this:
Open your quiz in the Quiz Builder and go to Results Page.
In the right-hand menu, expand Email Sign-up.
Enable Show an email sign-up on the Results page.
Customize the sign-up options if needed, such as the text, the First name and Last name fields and the GDPR Checkbox.
Publish your quiz to make the changes live.
The sign-up appears below the results by default, but you can move it using Page Layout. It also works on Results Pages that hide the default recommendations and use only content blocks.
The sign-up isn't shown when:
The customer already provided their email address or phone number earlier in the quiz, for example on the Optin Page.
Someone opens a saved or shared Results Page link.
If a customer skipped the Optin Page without providing an email address or phone number, the email sign-up can still appear on the Results Page.
For the full setup of each sign-up option, which integrations receive the email address and how customer information is handled, see Collect customer emails.
10. Share buttons
Share buttons let customers send your quiz to a friend on Facebook, X, WhatsApp or Pinterest, by email, by copying the link or through their device's Share menu. They share the quiz itself, not the customer's results.
Share buttons are off by default. To show them on the Results Page:
10.1 Open your quiz in the Quiz Builder and go to Results Page.
10.2 In the right-hand menu, open Share Buttons.
10.3 Tick Show share buttons on the Results page.
10.4 Choose the buttons you want and, if you like, add a heading, a message and a link to share.
10.5 Publish your quiz to make the changes live.
For the full setup, including what each button does and how to add share buttons to the Welcome Page, see Add share buttons to your quiz.
11. Customer Metafields
When Create Customer in Shopify is on, save up to three answers to the Shopify customer's metafields. Use {{ property_id }} as the value. Existing customers only get metafields they don't have yet. To learn more, see Shopify Customers.
12. Discounts
Lantern allows you to automatically apply a discount to quiz takers who purchase products recommended by the quiz. This can be a powerful way to increase conversions and encourage customers to complete their purchase.
To add an automatic discount:
Open your quiz Results Page in the editor
In the right-hand menu, go to Discount and pick one of your Shopify discount codes from the list. The first time, click Allow so Lantern can see your discounts; until then you can type the code. Lantern shows the code's status and warns you if it doesn't exist or has expired.
This discount will not be displayed to customers, but it will automatically apply to any eligible products the customer adds to cart from the Results Page.
If you don’t already have a discount code, you can create one in your Shopify admin:
Go to Shopify Admin → Discounts
Click Create discount
Select the type of discount you want to offer.
In most quiz use cases, Amount off products works best.Depending on your quiz strategy, you may also choose a discount for an entire collection or a store-wide discount.
Create the discount code:
Enter a custom discount code (for example:
10OFFALL)Choose the discount value (for example: 10% off)
Select the products or collections that should be eligible
This ensures the discount only applies to products recommended by the quiz.
Before saving the discount, review the additional options and adjust them based on your store’s needs:
Minimum purchase requirements
Example: none, or a minimum order valueCustomer eligibility
Example: all customersMaximum discount uses
Example: unlimited, if you want quiz takers to add multiple productsCombination rules
Decide whether this discount can be combined with other active discounts
Once everything is set, click Save discount. The discount is now live in Shopify.
With your code now live, you can copy it and paste it under the Discount section in the right-hand side menu on the Results Page.
For a full breakdown on how to visually display discounts, only show discounts as opt in rewards and advanced use cases, please check our dedicated guide: discount codes in Lantern quizzes.
Quick Setup Recommendations
For a fast and effective Results Page setup, we recommend:
Personalize the Header and Sub-header using quiz property IDs
Test Match Score or Weight thresholds, and add Default products so customers still see recommendations when nothing matches
Optimize layouts separately for mobile and desktop
Connect your existing review, cart, and subscription apps
These steps help create a clear, high-converting Results Page experience.










































