If you prefer, you can check out this information in video format.
Dynamic Content Blocks let you personalise sections of your Results Page with text, images, products and buttons. You can show a simple message, recommend a skincare routine or create a complete feeding plan based on the customer’s quiz responses.
You can choose exactly when content appears or show the closest content match based on the customer’s responses.
You can use Dynamic Content Blocks alongside your default product recommendations or include products within the blocks to build your entire Results Page.
Understand blocks and variants
A Dynamic Content Block is a section of your Results Page. Each block contains one or more variants, which are different versions of the content for that section.
For example, a skincare routine block could have three variants:
A routine for oily skin.
A routine for dry skin.
A routine for combination skin.
Each variant can have its own text, images and product recommendations. Lantern shows at most one variant from each block, based on the rules you set.
You can add multiple blocks to personalise different sections of your Results Page.
Create Dynamic Content with Claude or Caht GPT
If you’ve connected Lantern to ChatGPT or Claude using Lantern MCP, you can ask your assistant to create and configure Dynamic Content Blocks for you.
For example:
Create a personalised skincare routine on the Results Page. Add separate variants for oily, dry and combination skin, with advice and product recommendations for each. Show each variant only when the customer selects the corresponding skin type.
For more detailed results, explain when each variant should appear and what content or products it should include.
We recommend reading the rest of this guide even if your assistant handles the setup. Understanding how variants are selected will help you write clearer prompts and check that your results work as intended.
To get connected, see Connect Lantern's MCP to Claude or ChatGPT.
Step 1: Create a Dynamic Content Block
In the Quiz Builder, open the Results Page and click Add a Dynamic Content Block.
You can add a block above or below your default product recommendations, depending on where you want its content to appear.
Step 2: Add and name your variants
Create a variant for each version of the content you want the block to show.
For this guide, we’ll build a pet food recommendation block with six variants:
Normal-weight puppy
Overweight puppy
Normal-weight adult dog
Overweight adult dog
Normal-weight senior dog
Overweight senior dog
Each variant will include advice and three recommended products: a dry food, a wet food and a treat.
Use the Variant Nice Name field at the top of each variant to give it a recognisable name, such as “Normal-weight puppy”. This helps you identify it while editing.
Start with one variant. In the next step, we’ll customise its content before duplicating it to create the others.
Step 3: Customizing a Variant
Start with the Normal-weight puppy variant. We’ll add advice, an image and product recommendations.
Add personalised text
Enter the text you want customers to see. You can include values from their quiz responses using the question’s Property ID.
For example, if your pet-name question has the Property ID pet_name, you can use:
Here’s our recommended feeding routine for {{ pet_name }}.Lantern replaces {{ pet_name }} with the customer’s answer.
Add an image
Enable Include an Image, upload your image and configure its position and width.
For this example, we’ll position the image to the left of the text, with a width of 30% on desktop and 100% on mobile.
Add product recommendations
Enable Include Product Recommendations and add the products you want this variant to show.
For our normal-weight puppy variant, we’ll add one dry food, one wet food and one treat. You can link individual products or collections.
To rearrange individual products, hover over a product and drag it into position.
For linked collections, Default (Best for Collections) follows the collection’s sort order in Shopify. You can use the variant’s Sorting setting to sort by price, title, best selling or newest instead.
Duplicate your variant
Once the first variant’s content and layout are ready, use Clone Variant to create the others.
Update each copy’s Variant Nice Name, text, image and products as needed. In the next step, we’ll set when each variant should appear.
Step 4: Choose when a variant appears
There are two ways to choose which variant a customer sees:
Skip/Show Conditions: use specific rules to control when a variant appears.
Matching answers: show the closest match based on the customer’s selected answers.
You can use either approach or combine them within the same block. Lantern checks variants with conditions first.
Show a variant when its conditions are met
Use Skip/Show Conditions when a variant should appear only in specific circumstances. If you haven't used them before, we recommend you check out How to use Skip/Show Conditions.
For example, our Overweight puppy variant should appear only when the customer selects both Puppy and Overweight. Selecting just one of these answers should not qualify them for this variant.
To set this up:
4.1 In the Dynamic Content Block editor, find the variant and click Add conditions.
4.2 Choose Show and all.
4.3 Click Add Condition and enter the Property ID for the age question pet-age. Set it to match Puppy.
4.4 Add another condition using the weight question’s Property ID. Set it to match Overweight.
4.5 Click Save Content Block to save your changes.
Use the Property IDs and values from your own quiz. Conditions compare an answer’s Assigned Value when one is set, or its answer label otherwise.
You can also:
Choose any when only one of the listed conditions needs to pass.
Choose Skip to hide a variant when the selected conditions are met.
Use is provided to check whether the customer supplied information, such as an email address.
Compare numerical responses or calculated values, such as whether a value is greater than 25.
A variant with conditions displays the label Shown when its conditions pass in the editor.
Show the closest match using matching answers
Use matching answers when you want Lantern to choose the most suitable variant, even if the customer does not match every answer linked to it.
In each variant’s Matching Answers section, select the answers relevant to that variant. For example, you could connect a variant to:
Puppy
Overweight
Low activity
These are scoring opportunities, rather than three requirements. The variant can win even if the customer selects only some of these answers.
How matching-answer variants compete
By default, each selected matching answer adds 100 points to a variant. The variant with the highest qualifying total is shown.
For example, if a customer selects Puppy, Overweight and Moderate activity:
A variant connected to all three selected answers receives 300 points.
A variant connected only to Puppy receives 100 points.
The 300-point variant wins.
You can adjust answer weights to give certain answers more influence over this selection. For a detailed explanation, see Answer Weights in Dynamic Content Blocks.
Set a fallback variant
To provide content when none of your other variants qualify, enable This is a fallback variant on the variant you want to use as your safety net.
A fallback could contain general advice or recommendations suitable for a wider range of customers.
A variant with conditions cannot be marked as the fallback.
Which variant is shown?
Each Dynamic Content Block shows at most one variant. Lantern selects it in this order:
Check variants with conditions, from top to bottom. The first variant whose conditions pass is shown.
Compare variants without conditions using matching answers. This happens if no condition-based variant qualifies.
Show the fallback variant if none of the matching-answer variants qualify.
Show nothing if no variant qualifies and no fallback is configured.
Use the arrow buttons next to Remove to move variants up or down. Put more specific condition-based variants first—for example, Overweight puppy above a broader variant for all puppies.
If a variant has both conditions and matching answers, its conditions determine whether it appears. Its matching answers do not take part in variant selection, although they can still contribute to the [score] value if you display it in the variant’s text.
If you've connected Lantern to ChatGPT or Claude, you can ask your assistant to add conditions to a variant for you.
Step 5: Save and test
Once you’ve configured your variants, click Save Content Block and preview your quiz.
Try different answer combinations to check that the right content appears:
Conditions: test responses that meet the rules and responses that do not.
Overlapping conditions: check that the intended variant appears when more than one variant’s conditions pass.
Matching answers: check that the closest-match variant is selected, including when only some answers match.
Fallback: check that your fallback appears when no other variant qualifies. If you haven’t set one, check that the block shows nothing.
For our pet food example, test each age and weight combination: normal-weight and overweight puppies, adult dogs and senior dogs.
Check the text, images and products on both desktop and mobile. When you’re happy with the results, publish your quiz.
Arrange blocks on your Results Page
Dynamic Content Blocks can appear in two sections:
Top Dynamic Content Blocks: above your default product recommendations.
Bottom Dynamic Content Blocks: below your default product recommendations.
If you hide your default product recommendations and use only Dynamic Content Blocks, all blocks form part of the top section.
Show multiple blocks per row
By default, blocks appear one per row. To change this:
Open the Results Page in the Quiz Builder.
Open General Design.
Find Top Content Blocks Columns or Bottom Content Blocks Columns.
Choose how many columns to display. You can set up to four columns, with separate layouts for desktop and mobile.
These settings arrange separate blocks into columns. Each block still shows at most one of its variants.
Hide a block without deleting it
You can hide a Dynamic Content Block when you don’t currently need it; for example, a seasonal offer or holiday bundle that you might want to show again later.
The block keeps its variants, display rules, content, products and position on the Results Page.
To hide a block:
Open the Results Page in the Quiz Builder.
At the bottom of the block, click the eye button next to Edit and Delete.
Publish your quiz.
The block stays visible in the editor but appears faded with a Hidden label. Once published, customers won’t see it, its products won’t be sent to your integrations, and any discount code configured to apply automatically through that block won’t be applied.
To show the block again, click the eye button and publish your quiz.
If you use Page Layout to reorder your Results Page sections, the hidden block keeps its position there too.
You can also ask your connected AI assistant to hide or show a block using Lantern MCP.
Advanced content and file uploads
Add custom HTML
Use the Raw HTML field inside a variant to add custom HTML content.
The HTML renders as entered, so preview and test your changes before publishing.
Let customers upload files
You can add a file upload widget to a Dynamic Content Block so customers can upload images, videos or documents from the Results Page. File uploads are also available in regular Content Blocks.
For setup instructions, see How to Use the File Upload Feature in Your Quiz.
File uploads are not available on all Lantern legacy plans. If the option is unavailable, check your Billing dashboard for more information.
Additional notes
Using dates in conditions
Date Field responses are stored as text. You can check whether a date is provided, but you cannot directly compare whether it falls before or after another date.
For age-based conditions, enable Also send their age in the Date Field’s Integration Settings. Then use the resulting age property in your condition—for example, date_of_birth_age if the field’s Property ID is date_of_birth.
Sending variant data to integrations
Your connected integrations receive the variant the customer actually saw on the Results Page. If a block shows no variant, that block is not sent.
















