> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/test-steps/runner/wait-for-element-to-be-visible.md).

# Wait For Element To Be Visible

Wait For Element To Be Visible waits until the [Element](/elements/creating-elements.md) is shown within the current viewport. Use it when the next step needs the control on screen, not only present in the DOM.

See [Element states](/test-step-options/element-states.md) for how Visible differs from Displayed and Exists.

![Wait for element to be visible Test Step](https://app.does.qa/screenshots/node/action_wait_forElementVisible.png)

## When to use it

* Wait for a button or field to scroll into view before [Touch](/test-steps/action/touch.md).
* Confirm a sticky header or banner is on screen before asserting it.
* Prefer [Wait For Element To Be Displayed](/test-steps/runner/wait-for-element-to-be-displayed.md) when presence on the page is enough and viewport position does not matter.

## Configure

### Basics

| Field       | What to set                                               |
| ----------- | --------------------------------------------------------- |
| **Element** | The [Element](/elements/creating-elements.md) to wait for |

### Advanced

| Field                                 | What to set                                                |
| ------------------------------------- | ---------------------------------------------------------- |
| **How fast is this typically?**       | [Timeout Override](/test-step-options/timeout-override.md) |
| **Status on fail**                    | [Failed Status](/test-step-options/failed-status.md)       |
| **When should screenshots be taken?** | `Always` or `On Failures` (default)                        |

## Related

* [Wait For Element To Not Be Visible](/test-steps/runner/wait-for-element-to-not-be-visible.md)
* [Wait For Element To Be Displayed](/test-steps/runner/wait-for-element-to-be-displayed.md)
* [Element states](/test-step-options/element-states.md)
* [Runner](/test-steps/runner.md)

**Tags:** `action`, `wait`, `forElementVisible`, `wait`, `time`, `sleep`, `pause`, `element`, `delay`, `state`