What are Cues?

Cues are messages or prompts that you can create to automatically engage with visitors on your site based on certain criteria. Some common Cues include:

  • Cue users for questions about pricing when on the pricing page to help increase conversion rates.
  • Send a coupon code to the user when the user is about to leave your site.
  • Cue users for questions about a product if the user has been on a product page for a period of time.
  • Notify users about a pending sale, event, or site outage.

Cues work in conjunction with your Shoutbox, Lightbox, or as a standalone embeddable (with the base installation of reamaze.js).

When used in conjunction with a Shoutbox or Lightbox, Cues will inherit the same theme color and attributes belonging to your Shoutbox or Lightbox. To edit or change these configurations, use the Embeddable builder to do so.

Creating Cues
  • To start building a Cue, go to Settings > Cues. From this page, click "+ New Cue."

NOTE: Re:amaze automatically builds three example Cues for you, which you can edit or remove if they aren't needed.


  • First, pick the brand you want the Cue to display for. Make sure this matches the current Shoutbox/Lightbox implementation you have on your site. Next, give your Cue a name for easy referencing. This name is internal and not displayed to customers.
  • Compose the message you want the Cue to display to visitors. This can be anything from telling customers about a discount, a sale, or announcing a new product. If you're not sure how to write your message, you can click on the "Suggest Message" button to let Re:amaze's AI write your Cue for you. You can add a start and end date/time for your Cue if needed.
  • You can give your Cue a duration. This is the amount of time (in seconds) the Cue will be visible on a page. Enabling a duration will make the Cue transient by default, meaning that it will only appear once to a customer and will not display on other pages even if no action is taken.
  • Next, pick the avatar you want to use for this Cue. By selecting an Avatar, you are deciding "who" is delivering this message to your website visitors. You can select a generic brand avatar, staff member, team, or custom avatar.


Further down the Cue builder page, you'll see an option to add a button to your Cue. This is recommended if you'd like to take customers to a specific URL (their account page, shopping cart, etc). Give you button a name and the URL they'll be direct to. You can add additional buttons if you want and they'll be displayed underneath the button preceding it.

If you would like to extend your Cues' capabilities by adding a Custom Chatbot, you will need to add at least one action button as a Quick Response type button.


Next, you'll want to set up some rules and conditions for the Cue. Any given user must satisfy these conditions in order for the Cue to trigger and display. There are many to choose from so pick wisely! If you're unsure, create an easy Cue rule and you can always come back to edit it or create more later on. You can create multiple rules for your Cue.

Lastly, you may turn on or off certain advanced features.

  • Transient: Select this option if you'd like the Cue to disappear when the customer navigates to a different page
  • Bots enabled: Select this option if this Cue has an associated Custom Chatbot
  • Enable custom fields: Select this option if you'd like your Shoutbox/Chatbox embeddable has custom field options
  • Disable Cue click: Select this option if you don't want customers to click on the message itself to start a conversation and only allow them to click on the Action Buttons.

NOTE: If you'd like to create complex rules using custom JavaScript, you can leverage our notifications API to append additional rules.

When you're done setting up your Cue, click "Save" and Re:amaze provide you the JavaScript needed to paste into your site/store's HTML.

Implementing Cues

Implementing your Cue(s) is as easy as implementing your Shoutbox/Lightbox. If you're not using one of our supported eCommerce platforms like Shopify or BigCommerce, the preferred method is to use our Google Tag Manager integration.

If you don't want to use Google Tag Manager, you'll need manually install the Re:amaze Shoutbox and Cues. Once you have copied your Cue JavaScript code, head on over your site's HTML theme/editor and paste it next to your Shoutbox/Lightbox script (this should be between your <head> / </head> tags.

Alt Text

Once complete, save your work and refresh your site to test your Cue. Remember, all Cues will be displayed according to the rules you've assigned to it. If your Cue is not to show until the 9th visit, you won't be able to trigger it successfully until the 9th visit.

NOTE: Each Cue (built with the Cue Builder) you create is displayed only once per customer (until they clear their cookies). Advanced users of Cues should leverage the Notifications API to control time-based configurations. Advanced users should also visit the Cues API for further reference.

Shopify Liquid Rules in Cues

If you'd like to expand the power of Cues, you may use Shopify Liquid rules in Cues for more advanced functionality. See this article here.

Contact Us

Not finding what you're looking for? Contact Us Directly