> 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-displayed.md).

# Wait For Element To Be Displayed

Wait For Element To Be Displayed waits until the [Element](/elements/creating-elements.md) is shown on the page. Use it when the next step depends on UI that appears after an action or navigation.

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

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

## When to use it

* Wait for a success message, panel, or modal before the next interaction.
* Let a lazy-loaded section finish rendering before a [Touch](/test-steps/action/touch.md) step.
* Prefer [Wait For Element To Be Visible](/test-steps/runner/wait-for-element-to-be-visible.md) when the Element must be on screen in the current view.

## 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 Displayed](/test-steps/runner/wait-for-element-to-not-be-displayed.md)
* [Wait For Element To Be Visible](/test-steps/runner/wait-for-element-to-be-visible.md)
* [Element states](/test-step-options/element-states.md)
* [Runner](/test-steps/runner.md)

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