Triggering a Checklist
Leverage the use of the Checklist by triggering it in the right place, and at the right time.
When creating your Checklist, you must set up a trigger that will cause your widget to appear. You are provided with three options for this feature:
1. Beacon (Most Commonly Used)
If the user is evaluated as eligible to see the Checklist, the widget can be launched after clicking or hovering on the displayed beacon. You can specify the eligible users based on page, domain, and audience targeting as described in this article.
2. Element Click
If you would like to trigger the Checklist when the user clicks on a specific element in your web app for the widget to be shown. Once selected, you can specify the CSS selector for the target element in Userpilot.
There are two options when it comes to triggering the Checklist from an element, it can either be achieved by specifying the CSS selector of the element or by selecting a Feature Tag that you previously created. So for anyone without a technical background, we got you! You can refer to this document to learn how a Feature Tag is created.
Once it's created, you can easily select it from the drop-down list.
What is a CSS selector?
Elements are simply boxes on the page identified by its HTML and CSS, Userpilot identifies the element you have selected using CSS Selectors: these are used to select and target the HTML content on your web app. There are a wide variety of CSS selectors available, allowing for fine-grained precision when selecting elements to style; CSS selectors select HTML elements according to their id, class, type, attribute, etc.
Now you have the CSS selector of the element! You can paste it in the Trigger settings of the Checklist as you can see in the example below
We recommend asking your developers if you're missing information here.
3. Only Manually
There is more than one way to trigger the Checklist manually, it can be achieved using the permalink, programmatically, or via Userpilot content.
Option #1: Via Other Userpilot Content
Option #2: Shareable Permalink
The Permalink option will allow you to trigger the Checklist by including it in any URL. This is a great way to easily share a flow with a teammate or force a Checklist to trigger using a link you share with users in your email onboarding sequence.
Simply copy the permalink and add it to the end of the URL. Here is an example:
Option #3: Trigger Programmatically
Not only can this code be added in an element in your app, but it can also be added in a step of a Userpilot flow.
Pro tip: Triggering the widget manually can be a great way to test if the Checklist looks & feels as expected without publishing it live to your end-users.
Designing Your Beacon
Next, it's time to customize your Beacon! This includes color, Beacon Type, and Beacon Text.
With the Beacon Type feature, you can choose what you want your beacon to look like. Also, the Beacon Text feature allows you to edit the text you want to include in the beacon.
The Beacon could be positioned on the four corners of any page you want.