How to Set Up a Quiz Link Popup on Your Store¶
A link popup opens the quiz over the page the customer is already on. The link can sit in your navigation menu, on a button, a banner, a page or a blog post.
Before you start
You need a quiz built in the RevenueHunt app, and permission to edit your themes, pages and navigation.
Two things make a link popup work here.
-
Turn on the
Link Popup Quizapp embed in your theme, for every page. For one page only, add aLink Popup Quizsection to that page template instead. -
Use
#quizas the link. It goes in a menu item, a button, a banner, a page or a blog post.
Two things make a link popup work here.
-
Turn on the
Link Popup Quiz (Legacy)app embed in your theme. -
Use
#quiz-QUIZIDas the link. It goes in a menu item, a button, a banner, a page or a blog post.
Two things make a link popup work here.
-
Generate a link from the
Sharesection of the app. -
Paste that link into a menu item, a button, a banner, a page or a blog post.
Two things make a link popup work here.
-
Generate a link from the
Sharesection of the app. -
Paste that link into a menu item, a button, a banner, a page or a blog post.
Two things make a link popup work here.
-
Generate a link from the
Sharesection of the app. -
Paste that link into a menu item, a button, a banner, a page or a blog post.
Two things make a link popup work here.
-
Generate a link from the
Sharesection of the app. -
Paste that link into a menu item, a button, a banner, a page or a blog post.
Link popup in website menu¶
On every page¶
The menu item then opens the quiz over any page in your store.
Shopify 1.0 themes cannot run this
A quiz built in the Built for Shopify version needs an app embed or an app section, and both are Online Store 2.0 features. A Shopify 1.0 theme supports neither.
Upgrade to an Online Store 2.0 theme to use them.
-
In your Shopify admin, go to
Online Store > Themesand clickCustomizeon your live theme. -
Open
App embedsand turn onLink Popup Quiz. That adds theembed.jsscript to your store, so any#quizlink opens the popup.
-
Set the popup up.

Setting What it does Popup width (% of screen)How wide the popup opens Popup height (% of screen)How tall the popup opens Popup z-indexWhich other elements the popup sits in front of Quiz ID (optional)The quiz to open. Leave it empty for your default quiz Manage appOpens the RevenueHunt dashboard -
Click
Save. -
Go to
Content > Menusand open the menu you want the link in.
-
Click
Add menu itemand give it a label, such asTake the quiz. -
Type
#quizinto the link field, then clickSave.
The field takes the fragment, not a URL
Put
#quizin the link field on its own. A full address such ashttp://yourwebsite.com/#quizdoes not open the popup. -
Click
Saveon the menu. -
Open your store and click the new menu item. The quiz should open in a popup.
Which quiz opens
#quiz opens your default quiz.
With Shopify Markets set up, the default quiz for that market opens instead.
To open a particular quiz, see Open a specific quiz.
-
Open
Sharein the quiz builder, open theLinktab, thenShow Instructions for legacy themes. -
Click
Get the codeand copy the link. -
In your Shopify admin, go to
Online Store > Themesand clickCustomizeon your live theme. -
Open
App embedsand turn onLink Popup Quiz (Legacy). That adds theembed.jsscript to your store.The plain
Link Popup Quizembed serves the Built for Shopify version, so a legacy quiz opened through it reports that it does not exist.
-
Go to
Content > Menusand open the menu you want the link in.
-
Click
Add menu itemand give it a label, such asTake the quiz. -
Paste the copied link into the link field, then click
Save.
-
Click
Saveon the menu. -
Open your store and click the new menu item. The quiz should open in a popup.
-
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
In your WordPress admin, go to
Appearance > Menus. -
Pick a menu, add a
Custom Link, and paste the link into theURLfield. Give it a link text, such asTake the quiz.
-
Click
Save Menu. -
Open your store and click the new menu item. The quiz should open in a popup.
-
Add the
embed.jsscript before the closing</head>tag of your store header. The quiz does not load without it. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Go to
Catalog > Categoriesand add the link as a menu item. See the Adobe Commerce documentation on the top navigation. -
Save the category.
-
Open your store and click the new menu item. The quiz should open in a popup.
-
Add the
embed.jsscript before the closing</head>tag of your store header. The quiz does not load without it. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Go to
Storefront > Web Pagesand clickCreate a Web Page. -
Under
Page Type, chooseLink to Another website or document. -
Under
Web Page Details, put the quiz name inPage Nameand paste the link into theLinkfield. -
Under
Navigation Menu Options, tick the box that shows this page in the navigation menu. Pick a parent page, or leave it with none. -
Click
Save & Exit. -
Open your store and click the new menu item. The quiz should open in a popup.
-
Add the
embed.jsscript before the closing</head>tag of your store header. The quiz does not load without it. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open your store navigation settings, add a new item, and paste the link into it.
-
Save the menu.
-
Open your store and click the new menu item. The quiz should open in a popup.
On a specific page¶
The menu item then opens the quiz over one page only. Any other page built on the same template counts as that page.
Shopify 1.0 themes cannot run this
A quiz built in the Built for Shopify version needs an app embed or an app section, and both are Online Store 2.0 features. A Shopify 1.0 theme supports neither.
Upgrade to an Online Store 2.0 theme to use them.
A Link Popup Quiz section on one page template keeps the popup to that page, and to any other page built on the same template.
-
In your Shopify admin, go to
Online Store > Themesand clickCustomize. -
Open the page template menu and pick the template you want, or create one.
-
Click
Add section, open theAppsgroup, and addLink Popup Quiz.
-
Set the popup up.

Setting What it does Popup width (% of screen)How wide the popup opens Popup height (% of screen)How tall the popup opens Popup z-indexWhich other elements the popup sits in front of Quiz ID (optional)The quiz to open. Leave it empty for your default quiz Manage appOpens the RevenueHunt dashboard -
Click
Save. -
Apply the template to your page. In
Online Store > Pages, open the page and pick that template. -
Go to
Content > Menusand open the menu you want the link in.
-
Click
Add menu item, give it a label, and type#quizinto the link field.
The field takes the fragment, not a URL
Put
#quizin the link field on its own. A full address such ashttp://yourwebsite.com/#quizdoes not open the popup. -
Click
Saveon the menu. -
Open that page and click the menu item. The quiz should open there, and nowhere else.
Which quiz opens
#quiz opens your default quiz.
With Shopify Markets set up, the default quiz for that market opens instead.
To open a particular quiz, see Open a specific quiz.
Turning Link Popup Quiz (Legacy) on in App embeds adds the embed.js script to the whole store, so the popup opens over any page. There is no setting that limits it to one.
Limiting it to one page
A developer can leave the app embed off and add the script to a single page template instead, in a custom liquid or HTML block. The popup then opens on that page only.
Follow On every page for the rest of the steps.
-
Add the
embed.jsscript to the page template you want the popup on. The quiz does not load without it, and putting it on one template keeps the popup to that page. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
In your WordPress admin, go to
Appearance > Menus. -
Pick a menu, add a
Custom Link, and paste the link into theURLfield. Give it a link text, such asTake the quiz.
-
Click
Save Menu. -
Open that page and click the menu item. The quiz should open there, and nowhere else.
-
Add the
embed.jsscript to the page template you want the popup on. The quiz does not load without it, and putting it on one template keeps the popup to that page. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Go to
Catalog > Categoriesand add the link as a menu item. See the Adobe Commerce documentation on the top navigation. -
Save the category.
-
Open that page and click the menu item. The quiz should open there, and nowhere else.
-
Add the
embed.jsscript to the page template you want the popup on. The quiz does not load without it, and putting it on one template keeps the popup to that page. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Go to
Storefront > Web Pagesand clickCreate a Web Page. -
Under
Page Type, chooseLink to Another website or document. -
Under
Web Page Details, put the quiz name inPage Nameand paste the link into theLinkfield. -
Under
Navigation Menu Options, tick the box that shows this page in the navigation menu. -
Click
Save & Exit. -
Open that page and click the menu item. The quiz should open there, and nowhere else.
-
Add the
embed.jsscript to the page template you want the popup on. The quiz does not load without it, and putting it on one template keeps the popup to that page. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open your store navigation settings, add a new item, and paste the link into it.
-
Save the menu.
-
Open that page and click the menu item. The quiz should open there, and nowhere else.
Link popup as "take the quiz" button¶
On home page¶
The button sits on your home page. The app embed makes #quiz work across the store, so the same link works anywhere else you put it.
Shopify 1.0 themes cannot run this
A quiz built in the Built for Shopify version needs an app embed or an app section, and both are Online Store 2.0 features. A Shopify 1.0 theme supports neither.
Upgrade to an Online Store 2.0 theme to use them.
-
In your Shopify admin, go to
Online Store > Themesand clickCustomizeon your live theme. -
Open
App embedsand turn onLink Popup Quiz. That adds theembed.jsscript to your store, so any#quizlink opens the popup.
-
Set the popup up.

Setting What it does Popup width (% of screen)How wide the popup opens Popup height (% of screen)How tall the popup opens Popup z-indexWhich other elements the popup sits in front of Quiz ID (optional)The quiz to open. Leave it empty for your default quiz Manage appOpens the RevenueHunt dashboard -
Click
Add sectionand pickImage banner, or another section that can hold a button. -
Add a
Buttonblock inside that section. -
Click the button block and type
#quizinto its link field.
The field takes the fragment, not a URL
Put
#quizin the link field on its own. A full address such ashttp://yourwebsite.com/#quizdoes not open the popup. -
Click
Save. -
Open the page and click the button. The quiz should open in a popup.
Which quiz opens
#quiz opens your default quiz.
With Shopify Markets set up, the default quiz for that market opens instead.
To open a particular quiz, see Open a specific quiz.
-
Open
Sharein the quiz builder, open theLinktab, thenShow Instructions for legacy themes. -
Click
Get the codeand copy the link. -
In your Shopify admin, go to
Online Store > Themesand clickCustomizeon your live theme. -
Open
App embedsand turn onLink Popup Quiz (Legacy).The plain
Link Popup Quizembed serves the Built for Shopify version, so a legacy quiz opened through it reports that it does not exist.
-
Click
Add sectionand pickImage banner, or another section that can hold a button. -
Add a
Buttonblock inside that section, and paste the link into its link field.
-
Click
Save. -
Open the page and click the button. The quiz should open in a popup.
-
Add the
embed.jsscript before the closing</head>tag of your store header. The quiz does not load without it. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open the page you want the button on, in your page editor.
-
Add a
Buttonblock and paste the link into itsURLfield. -
Click
Update. -
Open the page and click the button. The quiz should open in a popup.
-
Add the
embed.jsscript before the closing</head>tag of your store header. The quiz does not load without it. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open the page in
Content > Pagesand clickEdit with Page Builder. -
Drag a
Buttonselement in, then paste the link into itsLinkfield. -
Save the page.
-
Open the page and click the button. The quiz should open in a popup.
-
Add the
embed.jsscript before the closing</head>tag of your store header. The quiz does not load without it. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open the page in
Storefront > Web Pages. -
Switch to the
HTMLeditor and add a link or button that points at the copied link. -
Save the page.
-
Open the page and click the button. The quiz should open in a popup.
-
Add the
embed.jsscript before the closing</head>tag of your store header. The quiz does not load without it. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open the page in your store editor.
-
Add a button and paste the link into its link field.
-
Save the page.
-
Open the page and click the button. The quiz should open in a popup.
On a specific page¶
The button opens the quiz over one page only. Any other page built on the same template counts as that page.
Shopify 1.0 themes cannot run this
A quiz built in the Built for Shopify version needs an app embed or an app section, and both are Online Store 2.0 features. A Shopify 1.0 theme supports neither.
Upgrade to an Online Store 2.0 theme to use them.
A Link Popup Quiz section on one page template keeps the popup to that page, and to any other page built on the same template.
-
In your Shopify admin, go to
Online Store > Themesand clickCustomize. -
Open the page template menu and pick the template you want, or create one.
-
Click
Add section, open theAppsgroup, and addLink Popup Quiz.
-
Set the popup up.

Setting What it does Popup width (% of screen)How wide the popup opens Popup height (% of screen)How tall the popup opens Popup z-indexWhich other elements the popup sits in front of Quiz ID (optional)The quiz to open. Leave it empty for your default quiz Manage appOpens the RevenueHunt dashboard -
Add a
Buttonblock to that template, and type#quizinto its link field.
The field takes the fragment, not a URL
Put
#quizin the link field on its own. A full address such ashttp://yourwebsite.com/#quizdoes not open the popup. -
Click
Save. -
Apply the template to your page. In
Online Store > Pages, open the page and pick that template. -
Open that page and click the button. The quiz should open there, and nowhere else.
Which quiz opens
#quiz opens your default quiz.
With Shopify Markets set up, the default quiz for that market opens instead.
To open a particular quiz, see Open a specific quiz.
Turning Link Popup Quiz (Legacy) on in App embeds adds the embed.js script to the whole store, so the popup opens over any page. There is no setting that limits it to one.
Limiting it to one page
A developer can leave the app embed off and add the script to a single page template instead, in a custom liquid or HTML block. The popup then opens on that page only.
Follow On home page for the rest of the steps.
-
Add the
embed.jsscript to the page template you want the popup on. The quiz does not load without it, and putting it on one template keeps the popup to that page. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open the page you want the button on, in your page editor.
-
Add a
Buttonblock and paste the link into itsURLfield. -
Click
Update. -
Open that page and click the button. The quiz should open there, and nowhere else.
-
Add the
embed.jsscript to the page template you want the popup on. The quiz does not load without it, and putting it on one template keeps the popup to that page. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open the page in
Content > Pagesand clickEdit with Page Builder. -
Drag a
Buttonselement in, then paste the link into itsLinkfield. -
Save the page.
-
Open that page and click the button. The quiz should open there, and nowhere else.
-
Add the
embed.jsscript to the page template you want the popup on. The quiz does not load without it, and putting it on one template keeps the popup to that page. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open the page in
Storefront > Web Pages. -
Switch to the
HTMLeditor and add a link or button that points at the copied link. -
Save the page.
-
Open that page and click the button. The quiz should open there, and nowhere else.
-
Add the
embed.jsscript to the page template you want the popup on. The quiz does not load without it, and putting it on one template keeps the popup to that page. -
Set the popup width, height and z-index, then click
Get the code. Copy the link it gives you. -
Open the page in your store editor.
-
Add a button and paste the link into its link field.
-
Save the page.
-
Open that page and click the button. The quiz should open there, and nowhere else.
FAQs¶
Open a specific quiz¶
#quiz opens your default quiz. To open another one, either use #quiz-QUIZID as the link, or put the ID in the Quiz ID (optional) field of the Link Popup Quiz settings.

Finding the Quiz ID
In the Dashboard, click the ... beside the quiz and select Copy Quiz ID. The ID is case-sensitive.
Shopify Markets
With Shopify Markets set up, the default quiz for the customer's market opens instead of your store default.
Generate the link from the Share tab of the quiz you want to open. The quiz is named in the link itself, as #quiz-QUIZID.
Finding the Quiz ID
In the Dashboard, click the ... beside the quiz and select Copy Quiz ID. The ID is case-sensitive.
Generate the link from the Share tab of the quiz you want to open. The quiz is named in the link itself, as #quiz-QUIZID.
Finding the Quiz ID
In the Dashboard, click the ... beside the quiz and select Copy Quiz ID. The ID is case-sensitive.
Generate the link from the Share tab of the quiz you want to open. The quiz is named in the link itself, as #quiz-QUIZID.
Finding the Quiz ID
In the Dashboard, click the ... beside the quiz and select Copy Quiz ID. The ID is case-sensitive.
Popup displays behind website header¶
The popup can open behind your store header, or with its X button hidden. That means the header is stacked in front of it, and the fix is the popup z-index.
The z-index decides which elements sit in front of which. Raise the popup one until it clears the header.
-
In your Shopify admin, go to
Online Store > Themesand clickCustomize. -
Open
App embedsand find theLink Popup Quizsettings. -
Raise
Popup z-index. Try1000, then10000.
-
Click
Save, then open the popup and check it sits in front of the header.
Do not raise it further than you need
A z-index set very high can cover things you want visible, such as a chat widget. The right value depends on your theme.
If the z-index does not fix it, put the quiz inline on a page of its own instead, and link to that page.
There is no z-index setting here, so the fix is in your theme. Three things to try, in this order.
Lower the z-index of your store header. That is a theme change, so check your theme files or ask your theme developer.
Move the X button down. Add this CSS to your theme, or to an empty HTML or custom liquid block on the page that shows the popup.
Put the quiz inline instead. Publish it on a page of its own and link to that page. The quiz is then part of the page, with no popup to stack.
There is no z-index setting here, so the fix is in your theme. Three things to try, in this order.
Lower the z-index of your store header. That is a theme change, so check your theme files or ask your theme developer.
Move the X button down. Add this CSS to your theme, or to an empty HTML block on the page that shows the popup.
Put the quiz inline instead. Publish it on a page of its own and link to that page. The quiz is then part of the page, with no popup to stack.
There is no z-index setting here, so the fix is in your theme. Three things to try, in this order.
Lower the z-index of your store header. That is a theme change, so check your theme files or ask your theme developer.
Move the X button down. Add this CSS to your theme, or to an empty HTML block on the page that shows the popup.
Put the quiz inline instead. Publish it on a page of its own and link to that page. The quiz is then part of the page, with no popup to stack.
There is no z-index setting here, so the fix is in your theme. Three things to try, in this order.
Lower the z-index of your store header. That is a theme change, so check your theme files or ask your theme developer.
Move the X button down. Add this CSS to your theme, or to an empty HTML block on the page that shows the popup.
Put the quiz inline instead. Publish it on a page of its own and link to that page. The quiz is then part of the page, with no popup to stack.
There is no z-index setting here, so the fix is in your theme. Three things to try, in this order.
Lower the z-index of your store header. That is a theme change, so check your theme files or ask your theme developer.
Move the X button down. Add this CSS to your theme, or to an empty HTML block on the page that shows the popup.
Put the quiz inline instead. Publish it on a page of its own and link to that page. The quiz is then part of the page, with no popup to stack.
Linking to multiple quizzes¶
One page can hold links to several different quizzes, each opening its own.
Use #quiz-QUIZID in place of #quiz, with a different ID on each link.
-
Open the Dashboard and find the quiz you want to link to.
-
Click the
...beside it and selectCopy Quiz ID.
-
Build the link as
#quiz-QUIZID. A quiz with the IDDmHLGjgives you#quiz-DmHLGj. -
Add it to a menu item or a button, following the steps above for either one.
-
Click each link in turn and check the right quiz opens.
What this is good for
- A different quiz per product category, such as one for skincare and one for makeup.
- Two versions of a quiz side by side, while you A/B test them.
- A seasonal or promotional quiz running alongside your main one.
The field takes the fragment, not a URL
Put #quiz-QUIZID in the link field on its own. A full address such as http://yourwebsite.com/#quiz-QUIZID does not open the popup.
Each quiz has its own link, so generate one per quiz.
Each quiz has its own link, so generate one per quiz.
Each quiz has its own link, so generate one per quiz.
Each quiz has its own link, so generate one per quiz.
Each quiz has its own link, so generate one per quiz.
The quiz you are looking for does not exist¶

Shopify 1.0 themes cannot run this
A quiz built in the Built for Shopify version needs an app embed or an app section, and both are Online Store 2.0 features. A Shopify 1.0 theme supports neither.
Upgrade to an Online Store 2.0 theme to use them.
This error means the link is being served by the embed for the other version of the app.
-
Go to
Online Store > Themes > Customize > App embedsand check which link embed is on. For a quiz built here,Link Popup Quizis the right one.
-
Turn
Link Popup Quiz (Legacy)off and turnLink Popup Quizon. -
Click
Save. -
Check your link is
#quiz, or#quiz-QUIZIDwith a valid ID.
This error means the link cannot find the quiz. The quiz may be unpublished, the wrong embed may be on, or the ID may be wrong.
-
Open the Quiz Builder and check the quiz is published, with the top-right
Publishbutton. -
Go to
Online Store > Themes > Customize > App embedsand turn onLink Popup Quiz (Legacy). The plainLink Popup Quizembed serves the Built for Shopify version. -
Copy the
Quiz IDfrom Quiz settings. The ID is case-sensitive. -
Check your link ends in
#quiz-QUIZID, with that ID. -
Click
Save, then reload the page.
This error means the link cannot find the quiz.
-
Open the Quiz Builder and check the quiz is published, with the top-right
Publishbutton. -
Copy the
Quiz IDfrom Quiz settings. The ID is case-sensitive. -
Check your link ends in
#quiz-QUIZID, with that ID. -
Check the
embed.jsscript is on the page. -
Save the page, then reload it.
This error means the link cannot find the quiz.
-
Open the Quiz Builder and check the quiz is published, with the top-right
Publishbutton. -
Copy the
Quiz IDfrom Quiz settings. The ID is case-sensitive. -
Check your link ends in
#quiz-QUIZID, with that ID. -
Check the
embed.jsscript is on the page. -
Save the page, then reload it.
This error means the link cannot find the quiz.
-
Open the Quiz Builder and check the quiz is published, with the top-right
Publishbutton. -
Copy the
Quiz IDfrom Quiz settings. The ID is case-sensitive. -
Check your link ends in
#quiz-QUIZID, with that ID. -
Check the
embed.jsscript is on the page. -
Save the page, then reload it.
This error means the link cannot find the quiz.
-
Open the Quiz Builder and check the quiz is published, with the top-right
Publishbutton. -
Copy the
Quiz IDfrom Quiz settings. The ID is case-sensitive. -
Check your link ends in
#quiz-QUIZID, with that ID. -
Check the
embed.jsscript is on the page. -
Save the page, then reload it.
This article explains how to open a quiz from a link, in a menu or on a button. It also covers what to check when the popup does not appear.