Skip to content

New Visibility Rules for Widgets

Understand the new Visibility Rules for widgets

Overview

The new Visibility Rules experience determine where, when, and to whom you display various Whatfix widgets, such as Self Help, Task List, Pop-ups, Launchers, Surveys, Beacons, and Smart Tips. These rules help you target specific user groups or contexts for showing relevant content. For example, configure Visibility Rules based on URL properties, other elements on the page, window variables, or attribute conditions.

The new Visibility Rules experience provides better control over the display of your Whatfix widgets. Compared to the old experience, it provides a more intuitive interface, expanded triggering options, and better support for advanced use cases. This enables you to create highly targeted and dynamic widget experiences. For a detailed comparison between the old and new Visibility Rules, see What has changed in New Visibility Rules?

  • The new Visibility Rules experience can only be used when configuring widgets at the segment level. Currently, Role Tags, Page Tags, Step display rules, and branching rules are still configured using the old Visibility Rules, even after migrating to the new Visibility Rules. This means that when configuring widgets at the step level, you still encounter the old rules rather than the new ones.
  • To know more about the new Visibility Rules, contact support@whatfix.com.

Here's an orientation video on the new Visibility Rules experience.

Getting started (CLM).mov


List of new Visibility Rule conditions

The following table lists all the conditions used while configuring the new Visibility Rules to segment widgets. These conditions determine when, where, and to whom Whatfix widgets are to be displayed on your application.

Click each new Visibility Rule condition in the following table for more information.

New Visibility Rule ConditionCorresponding Previous Visibility Rule ConditionDescription
Specific date range Enhanced Visibility Rules screenshotPart of the When condition (available only for Popup, Survey, Beacon, and Task List) Show widget from a specific date and time.
Something on the application Enhanced Visibility Rules screenshotOther Element Is Show widget based on the presence of a specific element on the page.
Users performing an action Enhanced Visibility Rules ScreenshotsUser Action Show widget based on the completion of a user action.
Events related to Whatfix content Enhanced Visibility Rules ScreenshotsAvailable only on the new Visibility Rules experienceShow widget based on callbacks from existing Whatfix content
URL vr2_select urlURL Show widget on the entire specified URL.
Domain vr2_select domainURL Hostname Show widget on a specific domain.
URL path vr2_select url pathURL Path Show widget on a specific section of a URL.
URL parameter vr2_select parameterURL Parameter Show widget based on parameters in the URL.
URL hash value vr2_select url hash valueURL Hash Show widget based on the hash value of the URL.
Page tags vr2_select page tagsPage Tag Show widget based on page tags assigned to the page.
Enterprise Attributes vr2_select enterprise attributesEnterprise Attributes Segment content based on user roles, departments, geography, accounts, and more.
User Attributes vr2_select user attributesUser Attribute Segment content based on end-user information from your application.
Roles vr2_select rolesRole Tag Show different content to users with different roles.
Cohorts vr2_select cohortUsers Show content to specific user groups based on certain use cases.

Configure a new Widget using the new Visibility Rules experience

Use the following steps to access the new Visibility Rules for any widget:

The following steps show how to configure the new Visibility Rules for a Pop-up. This process is similar for all other widgets.

  1. On the Whatfix Guidance dashboard, click Widgets. ia_left_nav_widgets

  2. Click Pop-ups. ia_widget_popups

  3. Hover your cursor over the Pop-up segment you want to configure, and then click the Edit icon. CLM_DB_Click_edit_icon.png

  4. Click Set Visibility Rules.

Enhanced Visibility Rules screenshot 2. On the Visibility rules page, set the following conditions:

Enhanced Visibility Rules screenshot

  1. Once you have added all required Visibility Rules, click Save.

vr2_save visibility rules 4. Finish creating the widget and then click Save.

vr2_save widget