## Sample usage

`REGEXP_CONTAINS(Page, 'home')`

## Syntax

`REGEXP_CONTAINS(X, regular_expression)`

### Parameters

- *`X`* - a field or expression to evaluate.

- *`regular_expression`* - a regular expression.

### Returns

The `REGEXP_CONTAINS` function returns **Boolean** data type values.

### Examples

| Example formula | Input | Output |
|---|---|---|
| ` REGEXP_CONTAINS(Field, 'A') ` | ABC123 | true |
| ` REGEXP_CONTAINS(Field, 'A.\*') ` | ABC123 | true |
| ` REGEXP_CONTAINS(Field, 'AC') ` | ABC123 | false |

### Notes

`REGEXP_CONTAINS` differs from the similar [`REGEXP_MATCH`](https://docs.cloud.google.com/data-studio/regexpmatch) function, which will only match the *entire* value by default. Thus, `REGEXP_CONTAINS(field,"pattern")` is functionally equivalent to `REGEXP_MATCH(field,".*pattern.*")`.

Data Studio uses the RE2 expression syntax. For more details, see [Regular Expressions in Data Studio](https://docs.cloud.google.com/data-studio/regular-expressions).

Note that patterns containing escape characters such as `\` may require additional escaping in Data Studio, which can be avoided with the use of [raw string literals](https://docs.cloud.google.com/data-studio/literals).

## Related resources

- [Regular expressions in Data Studio](https://docs.cloud.google.com/data-studio/regular-expressions)
- [Calculated fields](https://docs.cloud.google.com/data-studio/about-calculated-fields)
- [Data Studio function list](https://docs.cloud.google.com/data-studio/function-list)