When creating a new product tour, smart tips or a checklist it is crucial to set up the right targeting to ensure the content is shown in the right context to the right audience. Usetiful provides an easy targeting setup, enriched with advanced and specific options. 


Page targeting can be set up within the Settings section of a new or existing tour/smart tips group or checklist.




A content (e.g. a tour) can be displayed on any page where the Usetiful code is embedded. Page targeting allows you to narrow down the availability to certain pages, users, devices, browsers and more. 


If more than one condition is defined, you can select when the content shows up if all or any conditions are matched.


Condition nameDescription
URL-based conditions:
URL containsWhen this condition is set, Usetiful checks whether the page URL address contains the text value. You can enter the full address (such as 'https://yourpage.com/path') or just a relative path (such as '/path/index.html').
NEW URL equalsSpecify the URL where the tour must show. This field uses exact match logic, so please specify precise URL with https://www
URL regular expressionIf you need the tour to display on multiple pages you can enter the argument as a regular expression.

Examples of regular expressions can be found here.

 NEW Tour-relative conditions:
NEW Tour state isThis condition makes it possible to automatically start a tour if a different tour has not been started yet or has been closed.
The following options are available:
- Closed: if at any point in the tour the user clicks the "Close" button or reaches the last step of the specific tour - the tour is considered as closed.
- Not started - if the specified tour has never been opened before.
Based on the conditions of a specific tour above, you can automatically start a different tour. 
User-based conditions:
Tag isWhen this condition is set, the tour will show only if the given user has the expected tag. Find out more about how to segment users using tags here.
NEW Language isChecks for the preferred language of the visitor's browser. Read about this feature in more detail here.

Refer to HTML ISO language codes directory here.
NEW Browser isAllows starting the tour only if the page is opened in the selected browser (e.g. Chrome, Opera, etc). Select a browser from the list. 
Page content-based conditions:
Element exists

The tour will display only on pages that contain a specific HTML element. This allows you to target tours to users that have permission to see specific features.


In a similar way, you can use the negative condition 'Element doesn't exist'.

Element doesn't existOpposite of "Element exists" - target pages on which the specified element is not present.
Element text containsIn addition to the previous condition type, you can also check the text content of the select element. This is especially handy to detect different page languages or specific values displayed on a page.
Element attribute containsWith this condition, you can test the content of specific attributes on a given element.
Device-based conditions:
Device type isYou can target your tours to mobile, tablet or desktop devices.
NEW Operating system isThis option helps display the tour only if the visitor is using the specified OS. For example, a tour can be targeted only on users who are opening the page using Mac OS.
 Select a desired OS from the list.
NEW Local storage value isSpecify a key / value pair, which will ensure the tour is only displayed to users who have this local storage pair item in their browser. This is helpful to target tours based on users' previous interactions with your application or with other applications. 



Combine conditions

Combining mentioned conditions in the Page targeting section is possible - if combined, your content will be displayed when ALL or ANY defined conditions match. See the following examples.

Page targeting product tours

The first targeting definition ensures that the product tour will display on a page with 'domain.com' in the URL and when the page contains the element with selector '#element-1'.


Page targeting product toursThe second example will target the tour to 2 different subdomains, so on both will the tour be available.