# Introduction to the Data Diff Check

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

*Requires the Data Quality (DQ) module.*

The Data Diff check compares a target container against a reference container row by row and reports every row that was added, removed, or changed between the two. Use it to validate a replica or migration, reconcile a delivery with the system of record, or detect drift on a derived copy.

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, diff statuses, Row Identifiers, Comparators, and the filter clauses.

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

  The anomaly message the check produces, what the counts mean, and how differing rows appear side by side.

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

  Three production scenarios with sample data, anomaly messages, and the resulting comparison view.

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

  Guidelines for choosing Row Identifiers, tuning Comparators, scoping both sides, and keeping the cost down.

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

  Step-by-step tutorial for creating a Data Diff check between two containers.

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

  Step-by-step tutorial for changing the compared fields, Row Identifiers, reference container, Comparators, or filters.

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

  Common problems with row pairing, tolerated differences, scope mismatches, and cost, and how to resolve them.

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

  Payload shape and field notes for creating a Data Diff check programmatically.

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

  Short answers to questions about Row Identifiers, Comparators, change types, and anomaly reporting.

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

*Last updated: October 19, 2026.*
