Flow does not run correctly
  • 10 Jun 2024
  • 2 Minutes To Read
  • Dark
  • PDF

Flow does not run correctly

  • Dark
  • PDF

Article summary


The Flow fails to work correctly when displayed to the end users. The following are some instances of a Flow breaking:

  • The Flow fails to start.
  • The Flow fails to move to the next step even after clicking on the element.
  • The Flow Tooltip appears in an incorrect position.
  • The Flow skips a step.


There may be many reasons why your Flow is not working. The following are a few reasons and some solutions that you could try, to fix the issue:

  • The step conditions for the Flow may be incorrect or the step may be optional and the conditions don't match.
    • For example, one of the reasons could be that the step condition is being evaluated while the page is still loading. So if you are using the On click of selected element visibility rule, try switching to the On page refresh rule.
your title goes here

For more information, see Step completion rules.

  • Something may have changed in the underlying application, and Whatfix is unable to find the element that was selected when the flow was created.
  • Instead of simple element selection, a CSS Selector may be needed to ensure that the Flow step runs correctly.
  • The Flow may have been created in a non-production environment, but is being run in the production environment.
  • The application may be taking time to load and the visibility rule that determines the content display may not be optimized. For example, the rule may be set to be triggered by the On click of selected element because the page has not refreshed, the element that is supposed to trigger the next step has not yet been displayed, and thus, the step does not display.
    • Element IDs are different in UAT and Production and the account has been configured to Trust IDs.
  • There may be a conflict in the configuration and the Flow may not be displaying on the intended page.
  • You may have enabled the Always start this flow on step 1 toggle for the Flow. When this feature is enabled for a specific Flow, even if the user is not on the first screen of the Flow, instead of starting the Flow from the most relevant page that the user is on, the Flow is prompted to start from step 1.


  • Verify if the step conditions for the failed step are correctly configured.
  • Ensure that the Flow was created in an environment identical to what you have in production. The element attributes in production are often different compared to the attributes in UAT.
  • If the Flow was created in a UAT environment, and the account has been configured to trust IDs, ensure that the IDs are the same in both environments.
  • Always start a Flow from step 1 feature works only if the first step of the Flow is placed on a global element, that is, an element which is present across pages. In case you enable this feature for Flows where the first step is not on a global element, then the Flow breaks. Ensure that the first step of the Flow is placed on a global element for the Flow to run correctly.
your title goes here

If the issue persists, contact

Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.