Skip to main content

Set-up your Results Page

Written by Traian

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.

Image showing the Results Page of Lantern quiz builder with editable Header and Sub-header fields, where you can personalize the message using Property IDs.

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.

Image showing a personalized Header and Sub-header in the Results Page using the Property ID {{pet_name}}, with a preview of how it looks live.

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:

  1. Open your quiz in the Quiz Builder and go to Results Page.

  2. In the right-hand menu, expand Page Layout.

  3. Drag an element using the six-dot handle to move it to your preferred position.

  4. To restore the original arrangement, click Reset to the default order.

  5. Publish your quiz to make the changes live.

Image showing the Lantern Quiz Builder on the Results Page, with the Page Layout section expanded and the draggable Results Page elements visible in the right-hand menu.

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.

Image showing three Dynamic Content Blocks displayed side by side on the Lantern Results Page, with each block's Desktop width set to 1/3 and Mobile width set to Full in Page Layout.

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.

Image showing the expanded Reviews, Cart, and Subscriptions section on the right-hand side menu of the Results Page. The 'Show product reviews' checkbox is enabled, and a dropdown menu is visible for selecting integrated review apps.

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.

Image showing the Cart and Side Cart drawer settings, where integrated carts like Rebuy and theme-based drawers are listed for seamless quiz checkout experiences.

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.

Image showing the Cart and Side Cart Drawer settings inside the Reviews, Cart, Subscriptions dropdown, with “Do not open a cart page” unchecked and “If a cart page is opened, open it in a new tab” enabled, highlighted as the recommended configuration.

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

    GIF showing the Cart & Side Cart Drawer settings with no cart drawer selected and “Do not open a cart page” disabled, and a Lantern Results Page where clicking Add to Cart redirects to the store cart page in the same tab.
  • 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

    GIF showing the Cart & Side Cart Drawer settings with no cart drawer selected, “Do not open a cart page” disabled, and “If a cart page is opened, open it in a new tab” enabled, and a Lantern Results Page where clicking Add to Cart opens the store cart page 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.

Image showing available subscription app integrations like Recharge, Skio, Loop and more, for displaying subscription options on the Results Page.

3. Results Page design

General Design

Headline Design

You can also adjust:

  • Text alignment

  • Font size

This helps improve readability and engagement.

Image showing design settings for customizing the alignment and font size of the Results Page Headline and Sub-headline.

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.

Image showing button customization options for Add to Cart, Add All to Cart, and View More buttons on the Results Page.

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
    ​

Image showing additional button design settings like font size, border radius, width and padding for desktop and mobile.

Add to Cart Button

To send customers to the product page instead of adding the product to the cart:

  1. Open Results Page → Add to Cart Button.

  2. Turn off Show add to cart.

  3. 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:

  1. Open your quiz in the Quiz Builder and go to Results Page.

  2. In the right-hand menu, open Add All To Cart Button.

  3. Tick Show the total price in the button.

  4. 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.

Image showing customization options for the Add to Cart button on the Results Page, including button text override, alignment, quantity selector, and background and text colors.

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

Image showing the 'Show Product Description' option enabled under the Product Description settings and an example of how the full Shopify product description appears live in the Results Page recommendations.

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.

The Product Description section in the Results Page settings, with Show short description from product metafields ticked and lantern_description entered in the Metafield name field.

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.

Image showing the 'Show Short Description from Product Metafields' setting enabled and an example of how product descriptions using metafields appear live in the Results Page recommendations.

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

Image showing the

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

Product Recommendations settings with Total Product Recommendations set to “3 results”, Results Per Row (Desktop) at 3 and Results Per Row (Mobile) at 1

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.

  1. In Quiz Builder → Results Page, open Product Recommendations.

  2. Tick Let quiz takers replace a product - show a Replace link under each one.

  3. Publish your quiz.

The setting is off by default.

The Product Recommendations settings in the Results Page editor, with the checkbox 'Let quiz takers replace a product - show a Replace link under each one' ticked and outlined in red.

How replacements work

The three recommended dog food products on the Results Page, each with an Add to cart button and a highlighted Replace link underneath.

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.

Image showing Match Score Threshold and Total Weight Threshold settings to control which products appear based on quiz answers.

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
    ​

Image showing different Match Score display formats like percentage, fraction, or hidden.

​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.

Image showing the Sorting Priority dropdown in Lantern's Results Page settings, with Lowest Price selected. The expanded menu displays sorting options including Lowest Price, Highest Price, A–Z, Z–A, Random, Best selling (units sold, last 60 days), and Newest (product creation date).

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​

Image showing the setting to display a match explanation block above the Add to Cart button to boost transparency and trust.

6.9. Show Quantity Selector

Enable this option to let customers choose the quantity they want before adding a recommended product to their cart.

Image showing where to enable the quantity selector on the Results page and a live preview of how it appears.

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.

Products step of the quiz builder with Default products selected under When nothing matches, listing four products and the Add Products, Add Variants and Add Collections links

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.

Image showing the settings under the URLs section for returning users to their Results Page and enabling the Start Over option.

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.

Image showing the Results Page editor in Lantern, with the Go back link displayed next to Start over in the preview. Under the URLs settings, the

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.

Image showing settings for opening product links in new tabs and enabling UTM tracking on the Results Page.

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.

Image showing URL redirection settings for fallback, View More button, and redirecting users after completing the quiz.

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.

Image showing the Order and Customer Tags settings with the Shopify Flow section highlighted and the Send quiz completions to Shopify Flow checkbox enabled.

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.

Image showing the 'Enable order tagging' checkbox enabled within the Order & Customer Tags section, and below it, an input field labeled 'Order tag' is shown with a default value of 'Lantern Quiz' that can be changed.

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

Image showing the Enable Customer Tagging setting with a sample tag

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:

  1. Open your quiz in the Quiz Builder and go to Results Page.

  2. In the right-hand menu, expand Email Sign-up.

  3. Enable Show an email sign-up on the Results page.

  4. Customize the sign-up options if needed, such as the text, the First name and Last name fields and the GDPR Checkbox.

  5. Publish your quiz to make the changes live.

Image showing the Lantern Results Page with Email Sign-up enabled and its text customization settings highlighted.

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.

Image showing Lantern’s Results Page editor with Share Buttons expanded, the “Show share buttons on the Results page” checkbox enabled, and the corresponding share buttons highlighted in the preview.

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:

  1. Open your quiz Results Page in the editor

  2. 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.

Image showing the Discount section in the Results Page editor with an example of an automatic discount message.

If you don’t already have a discount code, you can create one in your Shopify admin:

  1. Go to Shopify Admin → Discounts

  2. Click Create discount
    ​

    create discount in Shopify Admin

    ​

  3. 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.
    ​

    discount type
  4. 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.

Image showing an example custom discount code


​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 value

  • Customer eligibility
    Example: all customers

  • Maximum discount uses
    Example: unlimited, if you want quiz takers to add multiple products

  • Combination 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.

Image showing discount rule settings like minimum purchase, max uses, combination rules, and active dates 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.

Image showing a discount code copied and pasted into the Discount section of the Results Page in Lantern.

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:

  1. Personalize the Header and Sub-header using quiz property IDs

  2. Test Match Score or Weight thresholds, and add Default products so customers still see recommendations when nothing matches

  3. Optimize layouts separately for mobile and desktop

  4. Connect your existing review, cart, and subscription apps

These steps help create a clear, high-converting Results Page experience.

Did this answer your question?