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

# Wait For Element To Not Be Displayed

Wait For Element To Not Be Displayed waits until the [Element](/elements/creating-elements.md) is no longer shown on the page. Use it after dismiss actions, route changes, or async updates that remove UI.

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

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

## When to use it

* Wait for a loading overlay or toast to disappear before the next step.
* Confirm a modal closed after Cancel or submit.
* Prefer [Wait For Element To Not Be Visible](/test-steps/runner/wait-for-element-to-not-be-visible.md) when the Element must leave the current viewport.

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

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