- 03 Nov 2025
- 4 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
Upgrade your content from existing Display Rules to the new Visibility Rules
- Aktualisiert am 03 Nov 2025
- 4 Minuten zu lesen
- Drucken
- DunkelLicht
- pdf
The new Visibility Rules on Studio help you decide where, when, and to whom your content should appear. They provide more flexibility and precision compared to the old Display Rules, making it easier to deliver the right guidance at the right time.
Once your account has the new Visibility Rules enabled, add them to any newly created content. To apply them to existing content, upgrade the associated content to use the new experience.
Why switch to the new experience of Visibility Rules?
Note:
Prerequisites for upgrading:
To upgrade your existing content to the new experience of Visibility Rules, ensure that new Visibility Rules are already enabled for your account. For more information, see new Visibility Rules for Content.
Upgrading to the new Visibility Rules enables you to:
Target elements precisely: Display content exactly where it is needed.
Observe user behavior dynamically: Continuously track user inputs and update guidance in real time.
Deliver personalized experiences: Show content based on conditions such as date ranges, user actions, and more.
Control visibility with multiple triggers: Manage content display based on other Whatfix content, application data, or user interactions.
Use a simplified and organized UI: Access improved terminology, descriptions, and a dedicated section for each rule type (Where, When, Who).
Segment users effectively: Define visibility for specific user groups with a separate Who section.
Achieve advanced use cases: Achieve use cases that previously required Advanced Customization (AC), such as:
Displaying content only under specific conditions
Linking different Whatfix content to create a guided journey
Observing user actions in real time and adapting guidance accordingly
How to upgrade your content to leverage the new experience of Visibility Rules?
Use the following steps to upgrade your existing content to the new Visibility Rules:
Info:
Upgrade your existing content to the new Visibility Rules using either Whatfix Studio or Whatfix Dashboard.
Expand the following accordions for more details.
Upgrade your content to the new Visibility Rules using Whatfix Studio
Use the following steps to upgrade your existing content to the new Visibility Rules using Whatfix Studio:
Note:
The following steps show the upgrade steps for a Beacon. The process is similar for other content such as Flow steps, Smart Tips, Launchers, and Blockers.
Upgrade is supported only at the step level. Bulk upgrade of content is not available.
On the Whatfix Guidance Dashboard, click Content.

Click Beacons.

Hover your cursor over the Beacon collection you want to edit, and then click the Edit icon.
.png?sv=2022-11-02&spr=https&st=2025-11-04T22%3A10%3A41Z&se=2025-11-04T22%3A20%3A41Z&sr=c&sp=r&sig=bpbO8ac%2Bzz85y2DVACxppAJrwyZj7Ec%2F6ZOLUS5L5yE%3D)
Click Launch live edit.

Once Whatfix Studio launches on the application, click the Beacon you want to upgrade.

Click Edit step.

Click Advanced Options.

On the Upgrade available for Display Rules banner, click Upgrade now.
.png?sv=2022-11-02&spr=https&st=2025-11-04T22%3A10%3A41Z&se=2025-11-04T22%3A20%3A41Z&sr=c&sp=r&sig=bpbO8ac%2Bzz85y2DVACxppAJrwyZj7Ec%2F6ZOLUS5L5yE%3D)
Note:
If your content cannot be upgraded due to any limitations, you will see the Upgrade unavailable for New Visibility Rules banner. For more information, contact support@whatfix.com.

On the Upgrade to New Visibility Rules dialog box, click Yes, upgrade.
Note:
When you click Yes, upgrade, all existing Display Rules are converted to the new Visibility Rules.

Once the upgrade is complete, go to Visibility Rules and add any additional new Visibility Rules as required.
.png?sv=2022-11-02&spr=https&st=2025-11-04T22%3A10%3A41Z&se=2025-11-04T22%3A20%3A41Z&sr=c&sp=r&sig=bpbO8ac%2Bzz85y2DVACxppAJrwyZj7Ec%2F6ZOLUS5L5yE%3D)
Click Save.
.png?sv=2022-11-02&spr=https&st=2025-11-04T22%3A10%3A41Z&se=2025-11-04T22%3A20%3A41Z&sr=c&sp=r&sig=bpbO8ac%2Bzz85y2DVACxppAJrwyZj7Ec%2F6ZOLUS5L5yE%3D)
Note:
If the content is not saved after the upgrade, you need to repeat the upgrade using the above-mentioned steps.
Preview the widget using Preview mode and then push the widget to Production.
Note:
This upgrade applies only to the current Beacon segment. If you need to upgrade other Beacons, you must do it individually.
Upgrade your content to the new Visibility Rules using the Whatfix Guidance Dashboard
Use the following steps to upgrade your existing content to the new Visibility Rules using the Whatfix Guidance Dashboard:
Note:
The following steps show the steps to upgrade the visibility rules for a Beacon. The process is similar for other content such as Flow steps, Smart Tips, Launchers, and Blockers.
Upgrade is supported only at the step level. Bulk upgrade of content is not available.
On the Whatfix Guidance dashboard, click Content.

Click Beacons.

Hover your cursor over the Beacon collection you want to edit, and then click the Edit icon.

Go to the Beacon and then click the Edit icon.

Click Advanced Options.
.png?sv=2022-11-02&spr=https&st=2025-11-04T22%3A10%3A41Z&se=2025-11-04T22%3A20%3A41Z&sr=c&sp=r&sig=bpbO8ac%2Bzz85y2DVACxppAJrwyZj7Ec%2F6ZOLUS5L5yE%3D)
On the Upgrade available for Display Rules banner, click Upgrade now.
Note:
If your content cannot be upgraded due to any limitations, you will see the Upgrade unavailable for New Visibility Rules banner. For more information, contact support@whatfix.com.

.png?sv=2022-11-02&spr=https&st=2025-11-04T22%3A10%3A41Z&se=2025-11-04T22%3A20%3A41Z&sr=c&sp=r&sig=bpbO8ac%2Bzz85y2DVACxppAJrwyZj7Ec%2F6ZOLUS5L5yE%3D)
On the Upgrade to New Visibility Rules dialog box, click Yes, upgrade.
Note:
When you click Yes, upgrade, all existing Display Rules are converted to the new Visibility Rules.
.png?sv=2022-11-02&spr=https&st=2025-11-04T22%3A10%3A41Z&se=2025-11-04T22%3A20%3A41Z&sr=c&sp=r&sig=bpbO8ac%2Bzz85y2DVACxppAJrwyZj7Ec%2F6ZOLUS5L5yE%3D)
After the upgrade, go to Visibility Rules and add any additional new Visibility Rules as required.
.png?sv=2022-11-02&spr=https&st=2025-11-04T22%3A10%3A41Z&se=2025-11-04T22%3A20%3A41Z&sr=c&sp=r&sig=bpbO8ac%2Bzz85y2DVACxppAJrwyZj7Ec%2F6ZOLUS5L5yE%3D)
Click Save to save the Beacon collection.

Note:
If the content is not saved after the upgrade, you need to repeat the upgrade using the above-mentioned steps.
Preview the widget using Preview mode and then push the widget to Production.
Note:
This upgrade applies only to the current Beacon segment. If you need to upgrade other Beacons, you must do it individually.
Limitations to consider before upgrading to the new Visibility Rules experience
While most Display Rules can be upgraded to the new Visibility Rules, certain conditions in the old rules are not supported in the new experience.
To simplify, let’s represent some of the older Display Rules as R1, R2, R3, and R4.
R1 → URL, URL Hostname, URL Path, URL Parameters, URL Hash
R2 → Other Element on Page, Window Variable
R3 → User Attributes, Enterprise Attributes, Salesforce Objects
R4 → Selected Element Is, Selected Element Text
The following combinations of rules cannot be upgraded, for all types of content:
Combination of Rules | Upgrade Status | Example | Images of the combination of Rules |
|---|---|---|---|
R1 OR R2 | Not possible | URL Hostname combined with OR Other Element on Page |
|
R2 OR R3 | Not possible | Other Element on Page combined with OR User Attribute |
|
R3 OR R1 | Not possible | User Attributes combined with OR URL Path |
|
R1 OR R2 OR R3 | Not possible | URL Hostname OR Other Element on Page OR User Attribute |
|
R4 OR any combinations of R1, R2, R3 | Not possible | Selected Element Is combined with OR URL Path OR User Attribute |
|
Note:
If a Smart Tip is configured with the Trigger condition - Based on property, upgradation of that specific trigger condition is not possible.
If your content cannot be upgraded due to one of the above limitations, contact support@whatfix.com for assistance.

.png?sv=2022-11-02&spr=https&st=2025-11-04T22%3A10%3A41Z&se=2025-11-04T22%3A20%3A41Z&sr=c&sp=r&sig=bpbO8ac%2Bzz85y2DVACxppAJrwyZj7Ec%2F6ZOLUS5L5yE%3D)



