Flow step timeouts — what they are and how to handle them

Prev Next

What is a flow step timeout?

When Userflow is waiting for a specific page element to appear before advancing to the next step, it monitors the page for that element. If the element doesn't appear within the configured timeout, the step times out.

By default, when a step times out, the flow auto-dismisses. You can change this behavior in your theme settings under Tooltip → Missing tooltip target behavior.

Why timeouts happen

Timeouts most commonly occur when:

  • Page elements load slowly due to large data queries, API calls, or client-side rendering delays

  • SPA navigation — in single-page apps, the new "page" may not fully render the target element within the window

  • Dynamic content — elements generated after user interaction take longer than expected to appear

Is the timeout configurable?

Yes. You can change the missing tooltip target tolerance in Settings → Themes → Tooltip → Missing tooltip target tolerance.

Workarounds for slow-loading elements

Option 1 — Use an "Element is present" trigger
Instead of targeting a specific element that loads slowly, configure the step to wait for a more reliable signal that the page is ready. For example, if a loading spinner disappears when content is ready, trigger on the spinner's absence rather than on the slow-loading element.

Option 2 — Use a URL-based trigger
If the slow-loading element appears on a specific page, configure the step to trigger on a URL match rather than an element match. URL matching is instant and doesn't depend on DOM load timing.

Option 3 — Increase the missing tooltip target tolerance
In Settings → Themes → Tooltip → Missing tooltip target tolerance, raise the tolerance value to give slow-loading elements more time to appear.

Option 4 — Break the step into smaller steps
If your flow advances through multiple slow-loading elements, consider splitting the flow into multiple steps with simpler trigger conditions.

When to contact support

If none of the above workarounds resolve the timeout issue, contact Userflow support at support@userflow.com. Provide:

  • The flow ID

  • The specific step where the timeout occurs

  • A description of the element being targeted and how long it typically takes to load