Skip to content

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.

  1. Access Theme Customization: Log in to your Shopify admin dashboard. Navigate to Online Store > Themes. Find your current theme and click on the Customize button. Make sure you are editing the Default theme or the theme that is applied to your main page.
  2. Add a Section: Then, + Add section, click the Apps. From the list, pick the Chat Button Quiz.

    manual_shopifyv2_pagelevel_chat_add

  3. Configure Popup Settings:

    manual_shopifyV2_quizbuilder_share_publish_chat_options

    • Adjust the color or the chat, icon, chat positon
    • Add a greetings message
    • Adjust the Popup Width and Height (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
  4. 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

  1. Copy Quiz ID: Go to your RevenueHunt app dashboard, select a quiz and click the ... button. Copy your Quiz ID.
  2. Open Store Themes: Go to Online Store > Themes, click Customize, then open App Embeds.
  3. Embed the Chat Button Quiz: Select Chat Button Quiz from the list.
  4. 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.
  5. Save Changes: Ensure all changes are saved before exiting the theme editor.

Option 2: Manual

  1. Obtain Chat Embed Code: From the quiz builder, click Share, select Chat button mode, and Show Instructions for Legacy Themes.
  2. Generate Popup Code: Adjust settings like welcome message, width or height and click Get code to generate an HTML code.
  3. Open Store Themes: In Themes, click Customize, add a Custom content section, then a Custom HTML/Custom liquid block.
  4. Paste Popup Code: In the HTML/custom liquid block, paste your popup code. paste this code into the HTML of your desired pages.
  5. Save Changes: Ensure all changes are saved before exiting the theme editor.
  1. Obtain Chat Embed Code: From the quiz builder, click Share, select Chat button mode.
  2. Generate Popup Code: Adjust settings like welcome message, width or height and click Get code to generate an HTML code. Copy the code.
  3. In WordPress, open Pages and find the Front Page. Click Edit to open the page.
  4. In the editor, find a Custom HTML element and add it to the page.
  5. In the element, paste the code copied from the app.
  6. Save the changes and update the page.
  7. From now on, the chat icon popup quiz will be visible on the main page.
  1. Add the following embed.js script before the </head> close tag in the header.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
    Without it, the quiz won't be loaded on your website.
  2. Obtain Chat Embed Code: From the quiz builder, click Share, select Chat button mode.
  3. Generate Popup Code: Adjust settings like welcome message, width or height and click Get code to generate an HTML code. Copy the code.
  4. In your Magento dashboard go to Content > Blocks. Click Add New Block.
  5. Edit the Block Title, Identifier and Store View and click Edit with Page Builder.
  6. Select Elements > Rows and drag a row into the canvas.
  7. Next open Elements and pick HTML Code. Drag the HTML Code onto the Row.
  8. Click the gear icon to open HTML settings.
  9. Under Enter HTML, CSS or JavaScript code paste the HTML code copied from the app.
  10. Remember to save the changes.
  11. From now on, the chat icon popup quiz will be visible on the main page.
  1. Add the following embed.js script before the </head> close tag in the header.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
    Without it, the quiz won't be loaded on your website.
  2. Obtain Chat Embed Code: From the quiz builder, click Share, select Chat button mode.
  3. Generate Popup Code: Adjust settings like welcome message, width or height and click Get code to generate an HTML code. Copy the code.
  4. In BigCommerce, go to Storefront > Web Pages. Find the main page.
  5. Switch to the HTML editor. Paste the HTML code copied from the app.
  6. Save the changes.
  7. From now on, the chat icon popup quiz will be visible on the main page.
  1. Add the following embed.js script before the </head> close tag in the header.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
    Without it, the quiz won't be loaded on your website.
  2. Obtain Chat Embed Code: From the quiz builder, click Share, select Chat button mode.
  3. Generate Popup Code: Adjust settings like welcome message, width or height and click Get code to generate an HTML code. Copy the code.
  4. In your store customization options find the main page.
  5. Find a Custom HTML element. In the element settings paste the code copied from the app.
  6. Save the changes.
  7. 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.

  1. Access Theme Customization: Log in to your Shopify admin dashboard. Navigate to Online Store > Themes. Find your current theme and click on the Customize button.
  2. 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 to App Embeds. Look for the Chat Popup Quiz option and toggle it on. manual_shopifyV2_quizbuilder_share_publish_onlinestore_chat
  3. Configure Popup Settings:

    manual_shopifyV2_quizbuilder_share_publish_chat_options

    • Adjust the color or the chat, icon, chat positon
    • Add a greetings message
    • Adjust the Popup Width and Height (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
  4. 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.

  1. To add a chat popup to a specific page, in Shopify, go to Online Theme > Customize. From the Home page menu on top, go to Pages and click on the page template you want to add the chat popup to or create a new page template.
  2. Then, + Add section, click the Apps. From the list, pick the Chat Button Quiz.

    manual_shopifyv2_pagelevel_chat_add

  3. You can adjust the chat button options:

    manual_shopifyv2_pagelevel_chat_added

    manual_shopifyV2_quizbuilder_share_publish_chat_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 hide

    Quiz ID (optional) - Enter a quiz ID to show a specific quiz. Leave blank to load the default.

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

  5. 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 to Visible and click on Save.

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.

  1. Obtain Chat Button Embed Code: From the quiz builder, click Share, select Chat button mode, and Show Instructions for Legacy Themes.
  2. Generate Popup Code: Adjust settings like color, width or height and click Get code to generate an HTML code.
  3. Embed Code on Page: In Shopify, go to Online Store > Pages, select the page, click Show HTML, and paste the popup code.
  4. Save Changes: Ensure all changes are saved before exiting the theme editor.
  1. Obtain Chat Button Embed Code: From the quiz builder, click Share, select Chat button mode.
  2. Generate Popup Code: Adjust settings like color, width or height and click Get code to generate an HTML code. Copy the HTML code.
  3. In WordPress, open Pages and find the page where you want the popup to show. Click Edit to open the page.
  4. In the editor, find a Custom HTML element and add it to the page.
  5. In the element, paste the code copied from the app.
  6. Save the changes and update the page.
  7. From now on, the chat button will be visible on that page.
  1. Add the following embed.js script before the </head> close tag in the header.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
    Without it, the quiz won't be loaded on your website.
  2. Obtain Chat Button Embed Code: From the quiz builder, click Share, select Chat button mode.
  3. Generate Popup Code: Adjust settings like color, width or height and click Get code to generate an HTML code. Copy the HTML code.
  4. In your Magento dashbaord go to Content > Pages. Click Add New Page or open an existing page.
  5. Edit the Page and open the Content tab. Click Edit with Page Builder.
  6. Select Elements > Rows and drag a row into the canvas.
  7. Next open Elements and pick HTML Code. Drag the HTML Code onto the Row.
  8. Click the gear icon to open HTML settings.
  9. Under Enter HTML, CSS or JavaScript code paste the HTML code copied from the app.
  10. Remember to save the changes.
  11. From now on, the chat button will be visible on that page.
  1. Add the following embed.js script before the </head> close tag in the header.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
    Without it, the quiz won't be loaded on your website.
  2. Obtain Chat Button Embed Code: From the quiz builder, click Share, select Chat button mode.
  3. Generate Popup Code: Adjust settings like color, width or height and click Get code to generate an HTML code. Copy the HTML code.
  4. In BigCommerce, go to Storefront > Web Pages. Click Create a Web Page or pen an existing page.
  5. Under Web Page Details > Page Content switch to the HTML editor. Paste the HTML code copied from the app.
  6. Save the changes.
  7. From now on, the chat button will be visible on that page.
  1. Add the following embed.js script before the </head> close tag in the header.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
    Without it, the quiz won't be loaded on your website.
  2. Obtain Chat Button Embed Code: From the quiz builder, click Share, select Chat button mode.
  3. Generate Popup Code: Adjust settings like color, width or height and click Get code to generate an HTML code. Copy the HTML code.
  4. In your store customization options find the page you want the quiz to show on.
  5. Find a Custom HTML element. In the element settings paste the code copied from the app.
  6. Save the changes.
  7. 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.

manual_shopifyV2_quizbuilder_share_publish_chat_options

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

docs/images/how_to_publish_shipifyV2_V1publisherror.png

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:

  1. Ensure that you have activated the Chat Button Quiz in the Online Store > Theme > Customize > App Embeds and not the the legacy Chat Button Quiz Legacy. how_to_publish_shipifyV2_V1publisherrorchatbutton

    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 the Chat Button Quiz one.

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

  1. Go back to the Quiz Builder and ensure that the quiz has been published with the top right Publish button.
  2. 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 the Chat Button Quiz option.
  3. Paste the Quiz ID in the Quiz ID field. Note: the Quiz ID is case-sensitive. how_to_publish_shipifyV2_V1publisherrorchatbutton
  4. 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:

  1. 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.
  2. 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.
  3. If the quiz is still not displayed,try adding our embed.js script to the page via a custom HTML element.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
  4. 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:

  1. 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.
  2. 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.
  3. If the quiz is still not displayed,try adding our embed.js script to the page via a custom HTML element.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
  4. 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:

  1. 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.
  2. 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.
  3. If the quiz is still not displayed,try adding our embed.js script to the page via a custom HTML element.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
  4. 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:

  1. Make sure you have added our embed.js script to the page via a custom HTML element.
    <script src="https://admin.revenuehunt.com/embed.js" async></script>
    
  2. 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.
  3. 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.
  4. 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.