--- title: "Understand Advanced Visibility Rules" slug: "understand-widget-behavior-with-advanced-visibility-rules" updated: 2025-11-02T16:59:30Z published: 2025-11-02T16:59:30Z canonical: "support.whatfix.com/understand-widget-behavior-with-advanced-visibility-rules" --- > ## 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 Advanced Visibility Rules > [!WARNING] > Note: > > New Visibility Rules are currently available only to selected customers. For more information, contact [support@whatfix.com](mailto:support@whatfix.com?subject=Regarding%20Advanced%20Visibility%20Rules&body=Hi%20Team%2C%20I%20don't%20have%20Advanced%20Visibility%20Rules%20enabled%20for%20my%20dashboard.%20Please%20help.%0A%0AThank%20you.). ### Overview Advanced Visibility Rules determine where, when, and to whom you display various Whatfix widgets, such as Self Help, Task List, and Pop-ups. 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. Advanced Visibility Rules 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. > [!WARNING] > Note: > > To know more about 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.). --- ### List of Advanced 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 Advanced Visibility Rule condition for more information. | Advanced Visibility Rule Condition | Corresponding Previous Visibility Rule Condition | Description | | --- | --- | --- | | Specific date range ![Enhanced Visibility Rules screenshot](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_start%20date%20time%20end%20date%20time.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Part of the When condition (available only for Popup, Survey, Task List) ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(305).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show widget from a specific date and time. | | Something on the application ![Enhanced Visibility Rules screenshot](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_something%20on%20the%20application.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Other Element Is ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(306).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show widget based on the presence of a specific element on the page. | | Users performing an action ![Enhanced Visibility Rules Screenshots](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_user%20performing%20an%20action.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | User Action ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(310).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show widget based on the completion of a user action. | | URL ![vr2_select url](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20url.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | URL ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(299).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show widget on the entire specified URL. | | Domain ![vr2_select domain](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20domain.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | URL Hostname ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(300).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show widget on a specific domain. | | URL path ![vr2_select url path](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20url%20path.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | URL Path ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(301).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show widget on a specific section of a URL. | | URL parameter ![vr2_select parameter](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20parameter.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | URL Parameter ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(302).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show widget based on parameters in the URL. | | URL hash value ![vr2_select url hash value](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20url%20hash%20value.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | URL Hash ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(303).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show widget based on the hash value of the URL. | | Page tags ![vr2_select page tags](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20page%20tags.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Page Tag ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(309).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show widget based on page tags assigned to the page. | | Enterprise Attributes ![vr2_select enterprise attributes](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20enterprise%20attributes.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Enterprise Attributes ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(308).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Segment content based on user roles, departments, geography, accounts, and more. | | User Attributes ![vr2_select user attributes](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20user%20attributes.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | User Attribute ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(307).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Segment content based on end-user information from your application. | | Roles ![vr2_select roles](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20roles.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Role Tag ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(311).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show different content to users with different roles. | | Cohorts ![vr2_select cohort](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/vr2_select%20cohort.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Users ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image(312).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) | Show content to specific user groups based on certain use cases. | --- ### Configure a New Widget using New Visibility Rules Use the following steps to access New Visibility Rules for any widget: > [!WARNING] > Note: > > The following steps show how to configure 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?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) 2. Click **Pop-ups**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/OS_Click_Pop-ups(1).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) 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?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) 4. Click **Configure**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/OS_Click_Configure.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) 5. Click **Set Visibility Rules**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/OS_Click_AVR.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) 6. On the **Visibility rules** page, set the following conditions: - **When does the pop up start and stop appearing?** - **Who does the pop up appear to?** ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/OS_VR.png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) 7. 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?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D) 8. Finish creating the widget and then click **Save.** ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/OS_Click_Configure(1).png?sv=2026-02-06&spr=https&st=2026-11-12T10%3A50%3A40Z&se=2026-11-12T11%3A50%3A40Z&sr=c&sp=r&sig=Cu8Dn2g7S0IgH63twXdQzuL7WKL37gerJidWEckhtPw%3D)