---
title: "Upgrade your Branched Flow steps to the new Visibility Rules"
slug: "upgrade-your-branched-steps-in-flows-from-existing-display-rules-to-the-new-visibility-rules"
updated: 2025-11-19T08:46:00Z
published: 2025-11-19T08:46:00Z
---

> ## 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.

# Upgrade your Branched Flow steps to the new Visibility Rules

Whatfix enables you to configure new Visibility Rules for branched Flow steps, providing a unified way to define when, where, and to whom your branched Flow steps appear.

To make use of the new Visibility Rules, you must upgrade your existing branching steps from the old Branching Rules to the new Visibility Rules.

> [!WARNING]
> Note:
> 
> - Upgrading branched steps is only supported at the Flow collection level. This means:
> 
> - All branched steps in a Flow must be eligible for the upgrade.
> - You cannot upgrade the Flow if even one branched step is ineligible. For example, you have a Flow with two branched steps, and one step is ineligible for the upgrade. In this case, the Flow cannot be upgraded. Only Flows where all branched steps are eligible can be upgraded.
> - If your content is ineligible for an upgrade due to any limitations, you see the **Upgrade unavailable for Branching Visibility Rules** banner. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Upgrade_unavailable.png) For more information on upgrade limitations, see [Limitations to consider before upgrading to the new Visibility Rules experience](https://support.whatfix.com/studio/docs/en/upgrade-your-content-from-existing-display-rules-to-the-new-visibility-rules?highlight=Limitations%20to%20consider%20before%20upgrading%20to%20the%20new%20Visibility%20Rules%20experience) or contact [support@whatfix.com](mailto:support@whatfix.com?subject=Need%20assistance%20with%20upgrading%20content%20to%20the%20new%20Visibility%20Rules&body=Team%2C%20%0AKindly%20help%20with%20upgrading%20content%20to%20the%20new%20Visibility%20Rules).

**Upgrade your branched steps to use the new Visibility Rules experience**

> [!WARNING]
> Note:
> 
> **Prerequisites for upgrading:**
> 
> To upgrade your existing branched steps to the new Visibility Rules experience, ensure that new Visibility Rules are already enabled for your account. For more information, see [new Visibility Rules for Content](/studio/docs/advanced-visibility-rules-for-content).

> [!NOTE]
> Info:
> 
> Upgrade your existing branched steps to the new Visibility Rules using either Whatfix Studio or Whatfix Dashboard.
> 
> Expand the following accordions for more details.

****Upgrade your branched steps to the new Visibility Rules using Whatfix Studio****

Use the following steps to upgrade your existing branched steps to the new Visibility Rules using Whatfix Studio:

1. On the Whatfix Guidance Dashboard, click **Content**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ia_left_nav_content.png)
2. Click **Flows**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/DB_Click_Flows.png)
3. Hover your cursor over the Flow you want to edit, and then click the **Edit**icon. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/DB_Click_Edit(1).png)
4. Click **Launch live edit**. ![Click launch live edit to edit the beacon](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Dashboard_Beacon_Launch live edit.png)

> [!NOTE]
> Info:
> 
> Once Whatfix Studio launches on the application, you see the **Upgrade available for Branching Rules**banner at the Flow collection level. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Branching_upgrade(1).png)
> 
> 
> 
> If your content is ineligible for an upgrade due to any [limitations](/studio/docs/upgrade-your-content-from-existing-display-rules-to-the-new-visibility-rules), you see the **Upgrade unavailable for Branching Visibility Rules** banner at the Flow collection level. For more information, contact [support@whatfix.com](mailto:support@whatfix.com?subject=Need%20assistance%20with%20upgrading%20content%20to%20the%20new%20Visibility%20Rules&body=Team%2C%20%0AKindly%20help%20with%20upgrading%20content%20to%20the%20new%20Visibility%20Rules). ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Upgrade_unavailable.png)
5. On the **Upgrade available for Branching Rules**banner, click **Upgrade now**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Branching_upgrade(2).png)
6. Click **Upgrade**.

> [!WARNING]
> Note:
> 
> When you click **Upgrade**, Whatfix converts all existing Branching Rules to the new Visibility Rules.

![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Click_Upgrade.png)
7. Once the upgrade is complete, go to branched Flow step, click **BRANCHING RULES**, and add any additional [new Visibility Rules](/studio/docs/advanced-visibility-rules-for-branching-in-flows) as required.

![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Click_BR.png)
8. Click **Save Branch**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Click_Save_Branch(1).png)

> [!WARNING]
> Note:
> 
> If the content is not saved after the upgrade, you need to repeat the upgrade process using the steps 1 to 8.
9. Preview the widget using [Preview mode](/studio/docs/how-to-use-preview-mode-to-review-content) and then [push the widget to Production](/studio/docs/pushing-whatfix-content-to-production).

****Upgrade your branched Flow steps 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:

1. On the Whatfix Guidance dashboard, click **Content**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image-4DGO4ZT5.png)
2. Click **Flows**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/DB_Click_Flows.png)
3. Hover your cursor over the Flow you want to edit, and then click the **Edit**icon. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/DB_Click_Edit(1).png)

> [!NOTE]
> Info:
> 
> In the Flow Edit Mode, you see the **Upgrade available for Branching Rules**banner at the Flow collection level. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/DB_Upgrade_Branch.png)
> 
> 
> 
> If your content is ineligible for an upgrade due to any limitations, you see the **Upgrade unavailable for Branching Visibility Rules** banner. For more information, contact [support@whatfix.com](mailto:support@whatfix.com?subject=Need%20assistance%20with%20upgrading%20content%20to%20the%20new%20Visibility%20Rules&body=Team%2C%20%0AKindly%20help%20with%20upgrading%20content%20to%20the%20new%20Visibility%20Rules). ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/DB_Branched_Update.png)
4. Click **Upgrade now**. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/DB_Click_Upgrade_now(1).png)
5. On the **Upgrade to advanced visibility rules** dialog box, click **Upgrade**.

> [!WARNING]
> Note:
> 
> When you click **Upgrade**, Whatfix converts all existing Branching Rules to the new Visibility Rules.

![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Click_upgrade.png)
6. After the upgrade, go to the branched Flow step, click **Branching Rules**, and add any additional [new Visibility Rules](/studio/docs/visibility-rules-for-beacons-on-studio) as required. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/Click_Branched_Rules.png)
7. Click **Save** to save the Flow. ![](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image-JCN6E1BZ.png)

> [!WARNING]
> Note:
> 
> If the content is not saved after the upgrade, you need to repeat the upgrade process using the steps 1 to 7.
8. Preview the widget using [Preview mode](/studio/docs/how-to-use-preview-mode-to-review-content) and then [push the widget to Production](/studio/docs/pushing-whatfix-content-to-production).