- 06 May 2024
- 4 Minutes To Read
-
Print
-
DarkLight
-
PDF
Create a Beacon
- Updated On 06 May 2024
- 4 Minutes To Read
-
Print
-
DarkLight
-
PDF
Beacon creation is a two-step process:
Step 2: Configure the segment for the Beacon
Step 1: Create the Beacon
Use the following steps to create a Beacon collection:
-
Log in to the application where you want to create content, and then launch Whatfix Studio.
-
On Whatfix Studio, click Beacon.
- Enter a name for the Beacon Collection.
- A Beacon collection is a group of Beacons and are usually on the same page.
- The Beacon collection name is solely for your (creator's) reference and is not visible to the end-user.
- Visibility Rules are defined for a Beacon collection. So even if you have only one Beacon on a page, it needs to be part of a collection.
-
Click + Add Beacon to create a new Beacon.
-
Select an element on the application where the Beacon must appear.
-
Enter a description for the Beacon action.
The Beacon description is visible to the end user when they hover their cursor over the Beacon.
- Enter the name of the Beacon.
The Beacon name is solely for your (creator's) reference and not visible to the end user.
-
In the CONFIGURATIONS tab, under the Disappear Beacon section, select the condition to stop displaying the Beacon.
-
Under the Appearance section, choose the style and Color of the Beacon.
-
Select the Custom style to configure the Text of your Beacon.
-
Once you start selecting the element to place the Beacon, your cursor changes to the set Beacon style. Then, you can place the Beacon to any desired position.
![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Beacon%20style%281%29.gif?sv=2022-11-02&spr=https&st=2024-09-08T01%3A21%3A53Z&se=2024-09-08T01%3A31%3A53Z&sr=c&sp=r&sig=6Sby9%2B5z7oItDZMshOMGiMZFaPWIMouNq6u1%2Fmefx38%3D)
- Under the Positioning section, adjust the position of the Beacon.
There are two different positioning modes,
-
In the Basic Positioning mode, you can choose among the 8 available positions.
-
In the Advanced Positioning mode, you can adjust the position of the Beacon by pixel. Either use the navigational arrows or enter the value in the Movement on key click(px) dropdown to change the position by pixels.
-
Click the Lock icon to unlock and reposition the Beacon.
- In the Tooltip Position section, choose the position of the tooltip.
Display Rules enable you to configure Beacons to display the tooltip only when pre-determined conditions are met.
Use the following steps to add Display Rules to a Beacon:
a. Click ADVANCED OPTIONS.
b. Expand the Display Rules section and then click + Add Rule.
c. Set the desired conditions. For more information on the different conditions that can be used in Display Rules, see Visibility and Display Rule Conditions.
Additional conditions can be added using + Add Rule, if needed.
- Click Save Beacon.
To add more Beacons, click + Add Beacon on the Studio, and then repeat steps 5 to 11.
- To save the Beacon collection, click Save Beacon.
-
Once you have created the Beacon collection, a segment is automatically created on your Whatfix dashboard.
-
To make content like Beacon or Smart Tip display on your page/ application, on the Whatfix Dashboard, go to the Widget section and move the associated Beacon segment from Draft to Production.
Edit a Beacon inside a collection during the Beacon creation process. For more information, see Edit Beacons.
Step 2: Configure the segment for the Beacon
If your account is Smart Context enabled, then Whatfix automatically configures the Visibility Rules. In that case, skip to step 7.
Use the following steps to configure a Beacon segment:
-
On the Whatfix Guidance dashboard, click Widgets.
-
Click Beacons.
- In the Draft stage, hover your cursor over the auto-created segment, and then click the Edit icon.
The Beacon collection that is attached is the newly published content.
- Expand the Set Visibility Rules section and configure your Visibility Rules that determine how the Beacon collection is displayed to the end user.
For more information on the different conditions that can be used in Visibility Rules, see Visibility and display rule conditions.
- Click the When tab, and then select the number of times you want to show the Beacon.
-
A Flow, Video, or Link can be attached to a Beacon.
-
To attach content to a Beacon, expand the attach content section, click Attach Content, and then select any content that you want to display to your users.
-
The attached content is displayed based on the Disappearance of Beacon setting you configured while creating it.
- Click Save.
- The Beacon stops displaying once the end user clicks it.
- To show the Beacon again, you can refresh the Beacon segment or re-create it.
- If Beacons are to be used for multiple pages, separate segments need to be created for each individual page.
- Subsequent changes to the Beacon collection do not update the corresponding segment.
-
Once you are done creating the Beacon collection, select the segment, and then click Send to ready.
-
Go to the Ready stage and select the segment you want to move to the Production stage, and then click Push to production.
If you're using the JS Embed method to test or publish Whatfix content, add the relevant conditions in Map Stages. This ensures that the content appears in the correct instance. For more information, see How to add conditions in Map Stages? (Log in to see the article)