# Regex

### What It Does

Performs regular expression search and replace operations on text. It finds patterns in your input string and replaces them according to your specified replacement pattern.

### Inputs

| Name    | Description                                                 | Type   | Required |
| ------- | ----------------------------------------------------------- | ------ | -------- |
| input   | The text to process                                         | String | Yes      |
| match   | The regular expression pattern to find                      | String | No       |
| flags   | Regex flags (like "g" for global, "i" for case-insensitive) | String | No       |
| replace | The replacement pattern                                     | String | No       |

### Outputs

| Name  | Description                        | Type   |
| ----- | ---------------------------------- | ------ |
| value | The text after pattern replacement | String |

<figure><img src="https://3657049418-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy0SFXZjN1sdgdxYM7QPE%2Fuploads%2FwZ7OL2NGHsQWeaaYpWpL%2FCleanShot%202025-04-03%20at%2015.26.26%402x.png?alt=media&#x26;token=2e88cf2b-d600-4d9c-817a-0011abf9e99f" alt=""><figcaption></figcaption></figure>

### How to Use It

1. Drag the Regex node into your graph.
2. Connect the text you want to process to the "input" input. For e.g., `color.red.100`.
3. Set the "match" value to the regular expression pattern you want to find (without the slashes). For e.g., `Color`.
4. Set any "flags" you need for the regex operation (e.g., "i" to make it case insensitive).
5. Define the "replace" pattern to substitute for matched text (e.g., `brand`).
6. The output will be a string `brand.red.100`, where `color` is replaced with `brand`.

<figure><img src="https://3657049418-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy0SFXZjN1sdgdxYM7QPE%2Fuploads%2FEzirO9cCCRGqBPc1wmQL%2FCleanShot%202025-04-03%20at%2015.25.00%402x.png?alt=media&#x26;token=7669aa56-cbc1-480a-8965-66e5c11e29d0" alt=""><figcaption></figcaption></figure>

### Tips

* Don't include the slash delimiters in your match pattern - just the pattern itself.
* Use the "g" flag to replace all occurrences rather than just the first match.
* Regex flags:&#x20;
  * `i` : Ignore case, case-insensitive matching.
  * `m` : Multi-line, multi-line matching.
  * `s` : Dotall, dot matches any char including newline.
  * `a` : ASCII, ASCII-only matching.
  * `x` : Verbose, ignore whitespace and comments.
* You can combine these flags in any order. For example:
  * `i` - Case insensitive matching
  * `im` - Case insensitive and multiline matching
  * `is` - Case insensitive and dot matches newline
  * `imsx` - Multiple flags combined

### See Also

* [**Replace**](https://documentation.tokens.studio/graph-engine/available-nodes/string/replace): For simple string replacement without regular expressions.
* [**Normalize**](https://documentation.tokens.studio/graph-engine/available-nodes/string/normalize): For standardizing text representation.

### Use Cases

* **Text Cleanup**: Remove or replace unwanted patterns or characters in text.
* **Format Conversion**: Transform text patterns from one format to another.
* **Data Extraction**: Isolate specific patterns from larger text blocks for token creation.