--- title: "Understand the new Visibility Rules for widgets" slug: "understand-visibility-rules-20" tags: ["AVR"] updated: 2025-11-03T03:08:01Z published: 2025-11-03T03:08:01Z --- > ## Documentation Index > Fetch the complete documentation index at: https://support.whatfix.com/llms.txt > Use this file to discover all available pages before exploring further. # 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?](/studio/docs/what-has-changed-in-visibility-rules-20) > [!WARNING] > Note > > - 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](mailto:support@whatfix.com?subject=Enable%20Visibility%20Rules%202.0&body=Hi%20team%2C%0A%0AI'm%20interested%20in%20trying%20out%20the%20Visibility%20Rules%202.0.%20Could%20you%20help%20me%20in%20enabling%20the%20feature%3F%0A%0AThanks%20and%20regards.). Here's an orientation video on the new Visibility Rules experience. [Getting started (CLM).mov](https://player.vimeo.com/video/1046649638?h=3c3cd51e2b&badge=0&autopause=0&player_id=0&app_id=58479) --- ### 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 Condition | Corresponding Previous Visibility Rule Condition | Description | | --- | --- | --- | | [Specific date range](/studio/docs/show-content-based-on-a-specific-date) ![Enhanced Visibility Rules screenshot](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_start%20date%20time%20end%20date%20time.png) | Part of the When condition (available only for Popup, Survey, Beacon, and Task List) ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(305).png) | Show widget from a specific date and time. | | [Something on the application](/studio/docs/show-content-based-on-something-seen-on-the-app) ![Enhanced Visibility Rules screenshot](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_something%20on%20the%20application.png) | Other Element Is ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(306).png) | Show widget based on the presence of a specific element on the page. | | [Users performing an action](/studio/docs/show-content-based-on-user-performing-an-action) ![Enhanced Visibility Rules Screenshots](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_user%20performing%20an%20action.png) | User Action ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(310).png) | Show widget based on the completion of a user action. | | [Events related to Whatfix content](/studio/docs/show-content-based-on-events-related-to-whatfix-content) ![Enhanced Visibility Rules Screenshots](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_events%20related%20to%20whatfix%20content.png) | Available only on the new Visibility Rules experience | Show widget based on callbacks from existing Whatfix content | | [URL](/studio/docs/set-where-your-widget-appears) ![vr2_select url](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20url.png) | URL ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(299).png) | Show widget on the entire specified URL. | | [Domain](/studio/docs/set-where-your-widget-appears) ![vr2_select domain](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20domain.png) | URL Hostname ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(300).png) | Show widget on a specific domain. | | [URL path](/studio/docs/set-where-your-widget-appears) ![vr2_select url path](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20url%20path.png) | URL Path ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(301).png) | Show widget on a specific section of a URL. | | [URL parameter](/studio/docs/set-where-your-widget-appears) ![vr2_select parameter](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20parameter.png) | URL Parameter ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(302).png) | Show widget based on parameters in the URL. | | [URL hash value](/studio/docs/set-where-your-widget-appears) ![vr2_select url hash value](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20url%20hash%20value.png) | URL Hash ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(303).png) | Show widget based on the hash value of the URL. | | [Page tags](/studio/docs/set-where-your-widget-appears) ![vr2_select page tags](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20page%20tags.png) | Page Tag ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(309).png) | Show widget based on page tags assigned to the page. | | [Enterprise Attributes](/studio/docs/set-who-can-see-your-widget) ![vr2_select enterprise attributes](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20enterprise%20attributes.png) | Enterprise Attributes ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(308).png) | Segment content based on user roles, departments, geography, accounts, and more. | | [User Attributes](/studio/docs/set-who-can-see-your-widget) ![vr2_select user attributes](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20user%20attributes.png) | User Attribute ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(307).png) | Segment content based on end-user information from your application. | | [Roles](/studio/docs/set-who-can-see-your-widget) ![vr2_select roles](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20roles.png) | Role Tag ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(311).png) | Show different content to users with different roles. | | [Cohorts](/studio/docs/set-who-can-see-your-widget) ![vr2_select cohort](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20cohort.png) | Users ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(312).png) | 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: > [!WARNING] > Note: > > 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](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ia_left_nav_widgets.png) 2. Click **Pop-ups**. ![ia_widget_popups](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ia_widget_popups.png) 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](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/CLM_DB_Click_edit_icon.png) 1. Click **Set Visibility Rules**. ![Enhanced Visibility Rules screenshot](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_set%20visibility%20rules.png) 2. On the **Visibility rules** page, set the following conditions: ![Enhanced Visibility Rules screenshot](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_main%20page.png) - [When does the pop up start and stop appearing?](/studio/docs/set-when-your-widget-appears-using-visiblity-rules-20) - [Where does the pop up appear?](/studio/docs/set-where-your-widget-appears) - [Who does the pop up appear to?](/studio/docs/set-who-can-see-your-widget) 3. Once you have added all required Visibility Rules, click **Save**. ![vr2_save visibility rules](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_save%20visibility%20rules.png) 4. Finish creating the widget and then click **Save.** ![vr2_save widget](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_save%20widget.png)