How to Add a Quiz Popup via a Chat-Like Button on Your Store¶
This guide provides step-by-step instructions on how to implement a chat button that opens the quiz feature, offering both theme-based and manual methods.
What's a Chat Button?
It's a button that opens the quiz popup when clicked. You can improve your Shopify / eCommerce store's interactivity by integrating a chat-like button that triggers a quiz popup.
Before you start
Before you start ensure you have a quiz created with the RevenueHunt app and access to the theme editor.
Chat Button on the Homepage¶
What's a Chat Button on the Homepage?
It's a chat-like button that shows up on the homepage of your store and when clicked opens the quiz popup.
Shopify 1.0 Theme Compatibility
Quizzes created with the đź’ŽBuilt for Shopify
version of the RevenueHunt app cannot be published on Shopify 1.0 themes. Shopify 1.0 themes do not support app embeds, which are required for the V2 integration. App embeds are a feature available in Online Store 2.0 themes, which allow you to add app functionality without touching any code. If you want to use app embeds, you would need to upgrade to an Online Store 2.0 theme.
- Access Theme Customization: Log in to your Shopify admin dashboard. Navigate to
Online Store > Themes
. Find your current theme and click on theCustomize
button. Make sure you are editing theDefault
theme or the theme that is applied to your main page. -
Add a Section: Then,
+ Add section
, click theApps
. From the list, pick theChat Button Quiz
. -
Configure Popup Settings:
- Adjust the
color
or the chat, icon, chat positon - Add a
greetings message
- Adjust the
Popup Width
andHeight
(as percentage of screen) - Set the
Popup z-index
to control layering with other elements - Set the
Popup Delay
(in seconds) - how long to wait before showing the popup - Set the
Quiz ID
(optional) to show a specific quiz. Leave blank to load the default. - Toggle
Trigger Popup on Exit Intent
if you want the popup to appear when users try to leave the page
- Adjust the
-
Save Changes: Click on the Save button to ensure all changes are saved before exiting the theme editor.
Note
When visitors come to your store, the default quiz for your store will open automatically based on your settings.
If you've configured Shopify Markets, the default quiz for that specific market will be shown instead.
If you want to show a specific quiz, you can do so by setting the Quiz ID
in the popup settings. Check this section for more information.
Option 1: Through Shopify Theme
- Copy Quiz ID: Go to your RevenueHunt app dashboard, select a quiz and click the
...
button. Copy your Quiz ID. - Open Store Themes: Go to
Online Store > Themes
, clickCustomize
, then openApp Embeds
. - Embed the Chat Button Quiz: Select
Chat Button Quiz
from the list. - Customize the Chat Button: Enter your Quiz ID into the appropriate field. Adjust the chat button settings as needed. Activate the chat button by toggling it on.
- Save Changes: Ensure all changes are saved before exiting the theme editor.
Option 2: Manual
- Obtain Chat Embed Code: From the quiz builder, click
Share
, selectChat button
mode, andShow Instructions for Legacy Themes
. - Generate Popup Code: Adjust settings like welcome message, width or height and click
Get code
to generate an HTML code. - Open Store Themes: In
Themes
, clickCustomize
, add aCustom content
section, then aCustom HTML
/Custom liquid
block. - Paste Popup Code: In the HTML/custom liquid block, paste your popup code. paste this code into the HTML of your desired pages.
- Save Changes: Ensure all changes are saved before exiting the theme editor.
- Obtain Chat Embed Code: From the quiz builder, click
Share
, selectChat button
mode. - Generate Popup Code: Adjust settings like welcome message, width or height and click
Get code
to generate an HTML code. Copy the code. - In WordPress, open
Pages
and find the Front Page. ClickEdit
to open the page. - In the editor, find a
Custom HTML
element and add it to the page. - In the element, paste the code copied from the app.
- Save the changes and
update
the page. - From now on, the chat icon popup quiz will be visible on the main page.
- Add the following embed.js script before the
</head>
close tag in the header. Without it, the quiz won't be loaded on your website. - Obtain Chat Embed Code: From the quiz builder, click
Share
, selectChat button
mode. - Generate Popup Code: Adjust settings like welcome message, width or height and click
Get code
to generate an HTML code. Copy the code. - In your Magento dashboard go to
Content
>Blocks
. ClickAdd New Block
. - Edit the Block Title, Identifier and Store View and click
Edit with Page Builder
. - Select
Elements
>Rows
and drag a row into the canvas. - Next open
Elements
and pickHTML Code
. Drag theHTML Code
onto the Row. - Click the gear icon to open
HTML settings
. - Under
Enter HTML, CSS or JavaScript code
paste the HTML code copied from the app. - Remember to save the changes.
- From now on, the chat icon popup quiz will be visible on the main page.
- Add the following embed.js script before the
</head>
close tag in the header. Without it, the quiz won't be loaded on your website. - Obtain Chat Embed Code: From the quiz builder, click
Share
, selectChat button
mode. - Generate Popup Code: Adjust settings like welcome message, width or height and click
Get code
to generate an HTML code. Copy the code. - In BigCommerce, go to
Storefront
>Web Pages
. Find the main page. - Switch to the
HTML
editor. Paste the HTML code copied from the app. - Save the changes.
- From now on, the chat icon popup quiz will be visible on the main page.
- Add the following embed.js script before the
</head>
close tag in the header. Without it, the quiz won't be loaded on your website. - Obtain Chat Embed Code: From the quiz builder, click
Share
, selectChat button
mode. - Generate Popup Code: Adjust settings like welcome message, width or height and click
Get code
to generate an HTML code. Copy the code. - In your store customization options find the main page.
- Find a
Custom HTML
element. In the element settings paste the code copied from the app. - Save the changes.
- From now on, the chat icon popup quiz will be visible on the main page.
Chat Button on All Pages¶
What's a Chat Button on All Pages?
It's a chat-like button that shows up on all pages of your store and when clicked opens the quiz popup.
Shopify 1.0 Theme Compatibility
Quizzes created with the đź’ŽBuilt for Shopify
version of the RevenueHunt appcannot be published on Shopify 1.0 themes. Shopify 1.0 themes do not support app embeds, which are required for the V2 integration. App embeds are a feature available in Online Store 2.0 themes, which allow you to add app functionality without touching any code. If you want to use app embeds, you would need to upgrade to an Online Store 2.0 theme.
- Access Theme Customization: Log in to your Shopify admin dashboard. Navigate to
Online Store > Themes
. Find your current theme and click on theCustomize
button. - Activate App Embeds: Make sure you are editing the
Default
theme or the theme that is applied to most of your pages. Within the theme customization area, go toApp Embeds
. Look for theChat Popup Quiz
option and toggle it on. -
Configure Popup Settings:
- Adjust the
color
or the chat, icon, chat positon - Add a
greetings message
- Adjust the
Popup Width
andHeight
(as percentage of screen) - Set the
Quiz ID
(optional) to show a specific quiz. Leave blank to load the default. - Set the
Popup z-index
to control layering with other elements
- Adjust the
-
Save Changes: Click on the Save button to ensure all changes are saved before exiting the theme editor.
Note
When visitors come to your store, the default quiz for your store will open automatically based on your settings.
If you've configured Shopify Markets, the default quiz for that specific market will be shown instead.
If you want to show a specific quiz, you can do so by setting the Quiz ID
in the popup settings. Check this section for more information.
If you want the chat button to appear across your entire store, follow the Manual Instructions and insert the code before the </body>
closing tag in your shop's theme.
If you want the chat button to appear across your entire store, follow the Manual Instructions and insert the code before the </body>
closing tag in your shop's theme.
If you want the chat button to appear across your entire store, follow the Manual Instructions and insert the code before the </body>
closing tag in your shop's theme.
If you want the chat button to appear across your entire store, follow the Manual Instructions and insert the code before the </body>
closing tag in your shop's theme.
If you want the chat button to appear across your entire store, follow the Manual Instructions and insert the code before the </body>
closing tag in your shop's theme.
Chat Button on a Specific Page¶
What's a Chat Button on a Specific Page?
It's a chat-like button that shows up on a specific page of your store and when clicked opens the quiz popup.
Shopify 1.0 Theme Compatibility
Quizzes created with the đź’ŽBuilt for Shopify
version of the RevenueHunt app cannot be published on Shopify 1.0 themes. Shopify 1.0 themes do not support app embeds, which are required for the V2 integration. App embeds are a feature available in Online Store 2.0 themes, which allow you to add app functionality without touching any code. If you want to use app embeds, you would need to upgrade to an Online Store 2.0 theme.
- To add a chat popup to a specific page, in Shopify, go to
Online Theme > Customize
. From theHome page
menu on top, go toPages
and click on the page template you want to add the chat popup to or create a new page template. -
Then,
+ Add section
, click theApps
. From the list, pick theChat Button Quiz
. -
You can adjust the chat button options:
Chat Button Color
- Adjust the color of the chat button by selecting one from the tool or adding a #color.Chat Icon Color
- Adjust the color of the chat icon by selecting one from the tool or adding a #color.Hide after quiz completion
- Hide the chat button after the customer reaches the results page. Toggle to activate.Show notification dot
- Show the small red notification dot on the chat icon. Toggle to activate.Greeting message
- Show and edit the greeting message displayed next to the chat icon. Leave it empty to hideQuiz ID (optional)
- Enter a quiz ID to show a specific quiz. Leave blank to load the default. -
Click on
Save
to save the changes. From now on, the chat popup will show up on that page or any page that uses the same template. - Remember to apply the new page template to the page you want to add the chat popup to. To add a new page to your store go to
Online Store > Pages
and click on+ Add Page
. In the page template section select the template you created, set the visibility toVisible
and click onSave
.
Note
When visitors come to your store, the default quiz for your store will open automatically based on your settings.
If you've configured Shopify Markets, the default quiz for that specific market will be shown instead.
If you want to show a specific quiz, you can do so by setting the Quiz ID
in the popup settings. Check this section for more information.
- Obtain Chat Button Embed Code: From the quiz builder, click
Share
, selectChat button
mode, andShow Instructions for Legacy Themes
. - Generate Popup Code: Adjust settings like color, width or height and click
Get code
to generate an HTML code. - Embed Code on Page: In Shopify, go to
Online Store > Pages
, select the page, clickShow HTML
, and paste the popup code. - Save Changes: Ensure all changes are saved before exiting the theme editor.
- Obtain Chat Button Embed Code: From the quiz builder, click
Share
, selectChat button
mode. - Generate Popup Code: Adjust settings like color, width or height and click
Get code
to generate an HTML code. Copy the HTML code. - In WordPress, open
Pages
and find the page where you want the popup to show. ClickEdit
to open the page. - In the editor, find a
Custom HTML
element and add it to the page. - In the element, paste the code copied from the app.
- Save the changes and
update
the page. - From now on, the chat button will be visible on that page.
- Add the following embed.js script before the
</head>
close tag in the header. Without it, the quiz won't be loaded on your website. - Obtain Chat Button Embed Code: From the quiz builder, click
Share
, selectChat button
mode. - Generate Popup Code: Adjust settings like color, width or height and click
Get code
to generate an HTML code. Copy the HTML code. - In your Magento dashbaord go to
Content
>Pages
. ClickAdd New Page
or open an existing page. - Edit the Page and open the
Content
tab. ClickEdit with Page Builder
. - Select
Elements
>Rows
and drag a row into the canvas. - Next open
Elements
and pickHTML Code
. Drag theHTML Code
onto the Row. - Click the gear icon to open
HTML settings
. - Under
Enter HTML, CSS or JavaScript code
paste the HTML code copied from the app. - Remember to save the changes.
- From now on, the chat button will be visible on that page.
- Add the following embed.js script before the
</head>
close tag in the header. Without it, the quiz won't be loaded on your website. - Obtain Chat Button Embed Code: From the quiz builder, click
Share
, selectChat button
mode. - Generate Popup Code: Adjust settings like color, width or height and click
Get code
to generate an HTML code. Copy the HTML code. - In BigCommerce, go to
Storefront
>Web Pages
. ClickCreate a Web Page
or pen an existing page. - Under
Web Page Details
>Page Content
switch to theHTML
editor. Paste the HTML code copied from the app. - Save the changes.
- From now on, the chat button will be visible on that page.
- Add the following embed.js script before the
</head>
close tag in the header. Without it, the quiz won't be loaded on your website. - Obtain Chat Button Embed Code: From the quiz builder, click
Share
, selectChat button
mode. - Generate Popup Code: Adjust settings like color, width or height and click
Get code
to generate an HTML code. Copy the HTML code. - In your store customization options find the page you want the quiz to show on.
- Find a
Custom HTML
element. In the element settings paste the code copied from the app. - Save the changes.
- From now on, the chat button will be visible on that page.
FAQs¶
Open a Specific Quiz¶
By default when add an chat button, the default quiz for your store will show.
Note
If you've configured Shopify Markets, the default quiz for that specific market will be shown instead.
If instead you want to open a specific quiz, you need to add a Quiz ID in the Quiz ID (optional)
field in the Chat Button Quiz
settings in the theme editor.
Quiz ID
To find your Quiz ID, go to the Dashboard, find the quiz you want to open. Then, click on the ...
three dots next to the quiz and select "Copy Quiz ID".
Keep in mind that the Quiz ID is case-sensitive.
To open a specific quiz as a chat button, just generate the embed code from the Share
tab of the desired quiz and add it to the page where you want the quiz to show.
To open a specific quiz as a chat button, just generate the embed code from the Share
tab of the desired quiz and add it to the page where you want the quiz to show.
To open a specific quiz as a chat button, just generate the embed code from the Share
tab of the desired quiz and add it to the page where you want the quiz to show.
To open a specific quiz as a chat button, just generate the embed code from the Share
tab of the desired quiz and add it to the page where you want the quiz to show.
To open a specific quiz as a chat button, just generate the embed code from the Share
tab of the desired quiz and add it to the page where you want the quiz to show.
The quiz you are looking for does not exist¶
Shopify 1.0 Theme Compatibility
Quizzes created with the đź’ŽBuilt for Shopify
version of the RevenueHunt app cannot be published on Shopify 1.0 themes. Shopify 1.0 themes do not support app embeds, which are required for the V2 integration. App embeds are a feature available in Online Store 2.0 themes, which allow you to add app functionality without touching any code. If you want to use app embeds, you would need to upgrade to an Online Store 2.0 theme.
If you see the error message "The quiz you are looking for does not exist" when trying to activate an automatic popup quiz, follow these steps:
-
Ensure that you have activated the
Chat Button Quiz
in the Online Store > Theme > Customize >App Embeds
and not the the legacyChat Button Quiz Legacy
.If a wrong chat button quiz is activated, you will see the error message "The quiz you are looking for does not exist" when trying to link to a V2 quiz.
To solve this simply deactivate the
Chat Button Quiz Legacy
and activate theChat Button Quiz
one. -
Save the changes.
If you see the error message "The quiz you are looking for does not exist" when trying to activate an chat button popup quiz, follow these steps:
- Go back to the Quiz Builder and ensure that the quiz has been published with the top right
Publish
button. - Go to Quiz Settings and copy the Quiz ID. Then in Shopify, go back to Online Store > Themes > Customize and under the
App Embeds
select theChat Button Quiz
option. - Paste the Quiz ID in the
Quiz ID
field. Note: the Quiz ID is case-sensitive. - Save your changes and refresh the page.
If you see the error message "The quiz you are looking for does not exist" when trying to activate an chat button popup quiz, follow these steps:
- Make sure to generate the correct embed code from the Share section. If in doubt, regenerate the embed code and re-paste it in the page.
- Ensure that the quiz is published and active. Go to the Quiz Builder and ensure that the quiz has been published with the top right
Publish
button. - If the quiz is still not displayed,try adding our embed.js script to the page via a custom HTML element.
- Save the changes and refresh the page.
If you see the error message "The quiz you are looking for does not exist" when trying to activate an chat button popup quiz, follow these steps:
- Make sure to generate the correct embed code from the Share section. If in doubt, regenerate the embed code and re-paste it in the page.
- Ensure that the quiz is published and active. Go to the Quiz Builder and ensure that the quiz has been published with the top right
Publish
button. - If the quiz is still not displayed,try adding our embed.js script to the page via a custom HTML element.
- Save the changes and refresh the page.
If you see the error message "The quiz you are looking for does not exist" when trying to activate an chat button popup quiz, follow these steps:
- Make sure to generate the correct embed code from the Share section. If in doubt, regenerate the embed code and re-paste it in the page.
- Ensure that the quiz is published and active. Go to the Quiz Builder and ensure that the quiz has been published with the top right
Publish
button. - If the quiz is still not displayed,try adding our embed.js script to the page via a custom HTML element.
- Save the changes and refresh the page.
If you see the error message "The quiz you are looking for does not exist" when trying to activate an chat button popup quiz, follow these steps:
- Make sure you have added our embed.js script to the page via a custom HTML element.
- Make sure to generate the correct embed code from the Share section. If in doubt, regenerate the embed code and re-paste it in the page.
- Ensure that the quiz is published and active. Go to the Quiz Builder and ensure that the quiz has been published with the top right
Publish
button. - Save the changes and refresh the page.
By following these instructions, you can successfully add a chat-like button to your Shopify/eCommerce store that opens a quiz popup.