Tooltip Targeting
Tooltip targeting controls which users see a tooltip, on which pages it appears, and how often it is displayed.
Trigger Types
Select the trigger that determines when the tooltip appears. See the Trigger Types table in the Creating Tooltips guide for the full list of available triggers and their configuration options.
Trigger rules are evaluated independently of audience rules — both must match for the tooltip to appear.
Audience Targeting
Assign an audience segment to restrict the tooltip to specific user groups. You can target by:
- User attributes -- Role, department, plan type, signup date, or custom properties passed via the SDK.
- Behavioral criteria -- Pages visited, flows completed, or actions performed.
- Predefined segments -- Reusable audience definitions from the Audiences section.
If no audience is assigned, the tooltip is shown to all users.
Page URL Rules
Define which pages the tooltip appears on using URL matching rules:
- Exact match -- The tooltip appears only on pages with an exact URL match.
- Contains -- The tooltip appears on any page whose URL contains the specified string.
- Starts with -- The tooltip appears on pages whose URL starts with the specified prefix.
- Regex -- The tooltip appears on pages whose URL matches a regular expression pattern.
Multiple page rules can be combined. The tooltip appears if any rule matches.
Display Frequency
Control how often a tooltip is shown to the same user:
| Frequency | Behavior |
|---|---|
| Every visit | The tooltip appears each time the user visits the page. |
| Once | The tooltip appears only the first time the user visits the page. After the user sees it, it does not appear again. |
| Every session | The tooltip appears once per browser session. |
| Until dismissed | The tooltip continues appearing on every visit until the user explicitly dismisses it. |
| Custom | Set a specific interval (e.g., once per week) or a maximum number of impressions. |
Dismissal Behavior
Configure what happens when a user dismisses a tooltip:
- Permanent dismiss -- The tooltip never appears again for that user.
- Session dismiss -- The tooltip is hidden for the rest of the current session but reappears in future sessions.
- Timed dismiss -- The tooltip is hidden for a configured duration (e.g., 24 hours) before reappearing.
Dismissed state is tracked per user via the SDK and persisted across sessions.
Element Visibility
Tooltips only render when their target element is present in the DOM and visible on the page. If the target element is removed or hidden (e.g., behind a tab or collapsed section), the tooltip hides automatically and reappears when the element becomes visible again.