# Find / Replace

Replaces all occurrences of the first string with the second. Includes support for regular expressions (regex), simple strings and extended strings (which support \n, \r, \t, \b, \f and escaped hex bytes using \x notation, e.g. \x00 for a null byte). Find / Replace lives in the **Utils** category of the `fx` menu.

## Parameters

| Parameter          | Type    | Required | Default | Description                                            |
| ------------------ | ------- | -------- | ------- | ------------------------------------------------------ |
| Input              | string  | yes      | —       | Value to transform. Previous step output or a literal. |
| Find               | string  | no       | —       | Argument value for this operation.                     |
| Replace            | string  | no       | —       | Argument value for this operation.                     |
| Global match       | boolean | no       | `true`  | Enabled by default.                                    |
| Case insensitive   | boolean | no       | `false` | Disabled by default.                                   |
| Multiline matching | boolean | no       | `true`  | Enabled by default.                                    |
| Dot matches all    | boolean | no       | `false` | Disabled by default.                                   |

`Input` is the primary value (previous step output or a literal).

## Returned value

| Type     | Description                                  |
| -------- | -------------------------------------------- |
| `string` | Result of the Find / Replace transformation. |

## Example

<details>
<summary>Run Find / Replace</summary>

Replaces all occurrences of the first string with the second. Adjust optional parameters when the defaults do not match your payload.

1. Set **Input** to the value to transform (previous step output or a literal).

2. Review **Find**, **Replace**, **Global match**, **Case insensitive**, **Multiline matching**, and other options and keep defaults unless your format requires otherwise.

3. Confirm **Output value** shows the transformed result.

</details>