---
title: "Flow step timeouts — what they are and how to handle them"
slug: "flow-step-timeouts"
updated: 2026-05-11T15:58:41Z
published: 2026-05-11T15:58:41Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.userflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

## 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](mailto: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