Messages Actions and Triggers

Messages Actions are the call to action you want to display to your visitor. Triggers define when to show the Message to your visitor. Once live, a Message will be shown one time per visitor.

Check out Messages for help adding the Messages add-on and creating your Message. Looking for more inspiration? Use cases has you covered there!

In this article


The Action setting allows you to define the action your visitor will take when clicking the button in your Message. In the example below Join a Live Class is the button text defined, and clicking that button will take the visitor to

In the Messages settings on the Customize tab, select the Action you would like the button to take and define the text for the button. 

Actions that are available to be selected depend on other settings in your Beacon. For example, if Chat is disabled in your Beacon, then Start Chat will not be an Action your Message can use. 

Action Description
Open Beacon Beacon opens as if the visitor had clicked on the Beacon icon, to the default Beacon screen as determined by your Beacon's mode setting
Open Article Opens Beacon and navigates to the specified Docs article. 
Search Docs Beacon opens and performs a search for your specified search query.
Start a Chat (if available) When Users are available to chat, clicking this button will open the Beacon and initiate a chat. If no Users are available to chat, Beacon will fallback and provide a link to the Send a Message screen instead. Check out User Availability and Maximum Chats for more there. 
New Conversation Opens Beacon to the Send a Message screen. Options here are determined by your Contact Form Options settings.
Open URL  Link to any website address. 
No Action No button will be displayed. The Message will display your Title, Subtitle, and Message text only. 


A Trigger is what determines when a Message appears on your page. A Message will only appear the first time a visitor matches the conditions when using the First Visit or Conditional triggers. To control how frequently your Message displays to visitors, select the Manual (JS) trigger and build your custom code to control when and where you show a Message. 

First Visit

The first time a visitor accesses the page, show the Message.

Manual (JS)

Use Beacon JavaScript API to custom code the Message initialization. Select this trigger to generate the JavaScript snippet you'll need to call to show your Message, then custom code when you show it. 

To show your Message more than once, add in the {force: true} option to your custom trigger code. For example: 

Beacon('show-message', 'MESSAGE_ID', { force: true })


Conditional trigger values can be combined using AND/OR logic. Each conditional type can only be used once per Message. The available conditions are described below. 

Condition Type Description
Time on Page Message will appear after the time specified.
Page Views After your visitor views the specified number of pages with Beacon, Message will appear.
Repeat Page Views Message appears after visitors have viewed the same page with the Beacon your specified number of times.
Page Scroll When the page is scrolled, the Message will appear.
Specific URL Message is displayed on load when specified page is visited. Up to 5 URLs can be specified. Wildcards ( * ) and relative URLs are supported. 
Identify Attribute Use the identify method to determine whether to show the Message, see Beacon JavaScript API: Identify. You can use a single identify attribute once per Message. 
Last Page Viewed Show Message if the referring URL matches your specified page. Up to 5 URLs can be specified. Wildcards ( * ) and relative URLs are supported.

Common Questions

Why do I see an error stating "This field is invalid" when trying to enter Identify attributes?
Each individual identify method can be used to trigger a single condition. For example, you can have a single Email > Contains > condition, but not Email > Contains > OR

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still stuck? How can we help? How can we help?