> 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/utility/replace-text.md).

# Replace Text

Replace Text overwrites visible text on the page or inside an [Element](/elements/creating-elements.md). Use it to mask sensitive content in screenshots or to simplify noisy copy during visual checks.

![Replace text Test Step](https://app.does.qa/screenshots/node/utility_replace_text.png)

## When to use it

* Mask personal data across the whole page before a [Screenshot](/test-steps/utility/screenshot.md) step.
* Replace text inside one panel when only that region should change.
* Choose a preset length or **Custom** value when the replacement text must match a fixed shape.

## Configure

### Basics

| Field                            | What to set                                                                          |
| -------------------------------- | ------------------------------------------------------------------------------------ |
| **Region**                       | `Page` (default) or `Element`                                                        |
| **Element** *(conditional)*      | The [Element](/elements/creating-elements.md) whose text to replace (Element region) |
| **New Value**                    | `Single Smile Character`, `150 Characters`, or `Custom`                              |
| **Custom Value** *(conditional)* | Replacement text when **New Value** is `Custom`                                      |

### Advanced

| Field              | What to set                                          |
| ------------------ | ---------------------------------------------------- |
| **Status on fail** | [Failed Status](/test-step-options/failed-status.md) |

## Related

* [Screenshot](/test-steps/utility/screenshot.md)
* [Debug Element](/test-steps/utility/debug-element.md)
* [Utilities](/test-steps/utility.md)

**Tags:** `utility`, `replace`, `text`