# Introduction to the Matches Pattern Check

Source: https://userguide.qualytics.io/data-quality-checks/matches-pattern/introduction/

*Requires the Data Quality (DQ) module.*

The Matches Pattern check asserts that every value in a text field matches a regular expression you provide. Use it when the accepted values follow a structure rather than a finite list: identifiers, codes, formatted references, and any field whose shape is the rule.

This section is the complete guide to the check. The Deep Dive covers the definition, properties, and full evaluation semantics, explains how anomalies are reported, walks through production examples, and collects best practices; the How-tos are step-by-step tutorials for creating, editing, and deleting a check; the API page documents the payload for programmatic use; and the FAQ answers the most frequent questions.

## Next Steps

- **How It Works**

  The complete reference: definition, field scope, the pattern property, matching semantics, NULL handling, arrays, filter behavior, and coverage.

  [How It Works](https://userguide.qualytics.io/data-quality-checks/matches-pattern/deep-dive/how-it-works/)
- **Anomaly Reporting**

  The anomaly messages the check produces, what the numbers mean, Source Records highlighting, and Custom Anomaly Description.

  [Anomaly Reporting](https://userguide.qualytics.io/data-quality-checks/matches-pattern/deep-dive/anomaly-reporting/)
- **Examples**

  Three production scenarios with sample data, anomaly messages, and the SQL equivalent of what the check evaluates.

  [Examples](https://userguide.qualytics.io/data-quality-checks/matches-pattern/deep-dive/examples/)
- **Best Practices**

  Guidelines for writing the expression, anchoring it, pairing rules, and keeping the signal clean.

  [Best Practices](https://userguide.qualytics.io/data-quality-checks/matches-pattern/deep-dive/best-practices/)
- **Permissions**

  The team permission each action needs: view, create, edit, archive, restore, and delete.

  [Permissions](https://userguide.qualytics.io/data-quality-checks/matches-pattern/deep-dive/permissions/)
- **Create a Check**

  Step-by-step tutorial for creating a Matches Pattern check with a regular expression.

  [Create a Check](https://userguide.qualytics.io/data-quality-checks/matches-pattern/how-tos/create-a-check/)
- **Edit a Check**

  Step-by-step tutorial for changing the pattern, or adjusting the filter, coverage, and organizational properties.

  [Edit a Check](https://userguide.qualytics.io/data-quality-checks/matches-pattern/how-tos/edit-a-check/)
- **Delete a Check**

  Step-by-step tutorial for archiving a check and deleting it permanently.

  [Delete a Check](https://userguide.qualytics.io/data-quality-checks/matches-pattern/how-tos/delete-a-check/)
- **Troubleshooting**

  Common problems with anchoring, escaping, NULLs, arrays, and anomaly reporting, and how to resolve them.

  [Troubleshooting](https://userguide.qualytics.io/data-quality-checks/matches-pattern/troubleshooting/)
- **API**

  Payload shape and field notes for creating a Matches Pattern check programmatically.

  [API](https://userguide.qualytics.io/data-quality-checks/matches-pattern/api/)
- **FAQ**

  Short answers to questions about anchoring, case sensitivity, NULLs, and anomaly reporting.

  [FAQ](https://userguide.qualytics.io/data-quality-checks/matches-pattern/faq/)

*Last updated: October 19, 2026.*
