> 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-step-options/screenshot-mode.md).

# Screenshot mode

Choose when screenshots are taken during a Test Step.

**Screenshot mode** controls when DoesQA captures screenshots during a Test Step. Use it to capture every step for thorough debugging, or only failures for routine checks.

Most action steps default to **Always**. Check and validator steps default to **On Failures**. Change the advanced field when you need different screenshot coverage.

## Options

| Mode            | What it means                                                               |
| --------------- | --------------------------------------------------------------------------- |
| **Always**      | Capture a screenshot every time this step runs, whether it passes or fails. |
| **On Failures** | Capture a screenshot only when this step fails or produces a warning.       |

## When to use each option

* Keep **Always** for critical actions such as login, payment, or data submission where you want visual proof the step ran correctly.
* Use **On Failures** for routine checks, wait steps, or high-frequency assertions where you only need screenshots when something goes wrong.

{% hint style="info" %}
**Pro tip:** Use Always on key actions like login or payment for a visual record of what happened. Use On Failures on routine checks to focus screenshots on problems.
{% endhint %}

## Which steps have Screenshot mode

Screenshot mode appears in the Advanced section of Test Steps that capture the page, including most action, check, validator, express, and runner steps.

## Related

* [Failed Status](https://docs.does.qa/test-step-options/failed-status.md)
* [Timeout Override](https://docs.does.qa/test-step-options/timeout-override.md)
* [Understand your results](https://docs.does.qa/getting-started/understand-your-results.md)
