# Introduction to the Expected Values Check

Source: https://userguide.qualytics.io/data-quality-checks/expected-values/introduction/

*Requires the Data Quality (DQ) module.*

The Expected Values check asserts that every value in a field comes from a list of allowed values. Use it to enforce a controlled vocabulary such as status codes, currencies, or country codes, and to catch values that drift outside the agreed set.

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, properties, matching rules, arrays, filter behavior, and coverage.

  [How It Works](https://userguide.qualytics.io/data-quality-checks/expected-values/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/expected-values/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/expected-values/deep-dive/examples/)
- **Best Practices**

  Guidelines for sizing the vocabulary, matching exactly, pairing rules, and keeping the signal clean.

  [Best Practices](https://userguide.qualytics.io/data-quality-checks/expected-values/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/expected-values/deep-dive/permissions/)
- **Create a Check**

  Step-by-step tutorial for creating an Expected Values check with a list of allowed values.

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

  Step-by-step tutorial for changing the allowed values, filter, coverage, or organizational properties.

  [Edit a Check](https://userguide.qualytics.io/data-quality-checks/expected-values/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/expected-values/how-tos/delete-a-check/)
- **Troubleshooting**

  Common problems with type mismatches, exact matching, arrays, and anomaly reporting, and how to resolve them.

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

  Payload shape and field notes for creating an Expected Values check programmatically.

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

  Short answers to questions about NULLs, matching, list size, and anomaly reporting.

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

*Last updated: October 19, 2026.*
