# Getting Started with Checks

Source: https://userguide.qualytics.io/data-quality-checks/checks/getting-started/

A check applies a **rule type** to a table or file and turns an expectation about the data into a result Qualytics evaluates on every Scan. The rule type decides what is checked. Everything else on a check, such as the filter, the coverage, the owner, and the tags, works the same way whichever rule you pick.

The Deep Dive pages explain the concepts every check shares, from how a check is evaluated to who creates and owns it. The How-tos walk through each task step by step, for any rule type. The Rule Types section lists every rule in the same groups as the rule type picker on the check form. The API page covers the endpoints, and the FAQ answers the common questions.

> **Info: Permissions**
>
> Anyone with a team permission on a datastore can view its checks. Creating, editing, archiving, and deleting checks need the **Drafter** or **Author** team permission, depending on whether the check is a Draft or Active. See [Check Permissions](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/permissions/) for the full matrix.

---

## Deep Dive

Understand what a check is, how it is evaluated, who creates and owns it, and what each part of its page shows.

### Concepts

- **Checks Introduction**

  Why checks matter and a map of every concept they share.

  [Checks Introduction](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/introduction/)
- **How a Check Works**

  What a check is made of, how a Scan evaluates it, and how its status changes.

  [How a Check Works](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/how-it-works/)
- **Authored Checks**

  Checks your team writes and governs, which automation never changes.

  [Authored Checks](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/authored-checks/)
- **AI Managed Checks**

  Checks Qualytics generates from observed data, and the edits that make them Authored.

  [AI Managed Checks](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/ai-managed-checks/)
- **Check Ownership**

  Who is responsible for each check, and how ownership changes.

  [Check Ownership](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/ownership/)
- **Check Importance**

  How much a check's failures matter when Qualytics ranks the impact of its anomalies.

  [Check Importance](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/importance/)
- **Impact Metrics**

  Measure how big a failure is in business terms, such as the amount or the customers affected.

  [Impact Metrics](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/impact-metrics/)
- **Dry Run**

  Test a check against a sample of its data, without creating anomalies or running a Scan.

  [Dry Run](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/dry-run/)

### Check Details

- **Check Views**

  The check lists, the check page, and the side panel: how to reach each one and what it shows.

  [Check Views](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/check-details/check-views/)
- **Check Anomalies**

  Every anomaly a check has produced, to triage without leaving the check.

  [Check Anomalies](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/check-details/anomalies/)
- **Check Timeline**

  Everything that happened to a check: its creation, every change, and your team's comments.

  [Check Timeline](https://userguide.qualytics.io/data-quality-checks/checks/deep-dive/check-details/timeline/)

### Examples and Permissions

- **Check Examples**

  Scenarios that show ownership and AI Managed checks in practice.

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

  Which team permissions each check action needs.

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

---

## How-tos

Work with checks of any rule type step by step, grouped by what each task changes.

### Status

- **Activate Draft Checks**

  Turn a Draft check on, so the next Scan evaluates it.

  [Activate Draft Checks](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/status/activate-draft-check/)
- **Draft Checks**

  Pause an Active check without losing its configuration.

  [Draft Checks](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/status/draft-checks/)
- **Archive Checks**

  Retire a check from Scans and keep it for reference.

  [Archive Checks](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/status/archive-check/)
- **Restore Archived Checks**

  Bring an archived check back as Active or Draft.

  [Restore Archived Checks](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/status/restore-archived-checks/)

### Managing

- **Create a Check**

  Create a check of any rule type with the check form.

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

  Change one check, or the owner and other settings of many checks at once.

  [Edit Checks](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/managing/edit-checks/)
- **Clone a Check**

  Create a new check from the configuration of an existing one.

  [Clone a Check](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/managing/clone-check/)
- **Delete Checks**

  Remove archived checks permanently.

  [Delete Checks](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/managing/delete-checks/)
- **Mark a Check as Favorite**

  Keep the checks you follow one click away.

  [Mark a Check as Favorite](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/managing/check-favorite/)

### Test and Find Checks

- **Dry Run a Check**

  Test a check against a sample of its data before it goes live.

  [Dry Run a Check](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/dry-run/)
- **Filter and Sort Checks**

  Narrow and order any check list.

  [Filter and Sort Checks](https://userguide.qualytics.io/data-quality-checks/checks/how-tos/filter-and-sort/)

---

## Rule Types

Every rule type, in the same groups as the rule type picker on the check form. Each one has its own section with the full reference, examples, how-tos, and API.

> **Tip: Not sure which rule to pick?**
>
> Start from the question you want answered, not from the field. "Is this value inside a range" leads to a different rule than "do these two tables agree", even when both look at the same column.

### Single Field

Rules that check the values of one field, such as a range, a pattern, a date, or a list of allowed values.

- **After Date Time**

  Asserts that the field is a timestamp later than a specific date and time.

  [After Date Time](https://userguide.qualytics.io/data-quality-checks/after-date-time/introduction/)
- **Before Date Time**

  Asserts that the field is a timestamp earlier than a specific date and time.

  [Before Date Time](https://userguide.qualytics.io/data-quality-checks/before-date-time/introduction/)
- **Between**

  Asserts that values are equal to or between two numbers.

  [Between](https://userguide.qualytics.io/data-quality-checks/between/introduction/)
- **Between Times**

  Asserts that values are equal to or between two dates or times.

  [Between Times](https://userguide.qualytics.io/data-quality-checks/between-times/introduction/)
- **Contains Credit Card**

  Asserts that the values contain a credit card number.

  [Contains Credit Card](https://userguide.qualytics.io/data-quality-checks/contains-credit-card/introduction/)
- **Contains Email**

  Asserts that the values contain email addresses.

  [Contains Email](https://userguide.qualytics.io/data-quality-checks/contains-email/introduction/)
- **Contains Social Security Number**

  Asserts that the values contain social security numbers.

  [Contains Social Security Number](https://userguide.qualytics.io/data-quality-checks/contains-social-security-number/introduction/)
- **Contains Url**

  Asserts that the values contain valid URLs.

  [Contains Url](https://userguide.qualytics.io/data-quality-checks/contains-url/introduction/)
- **Distinct Count**

  Asserts on the approximate count distinct of the given column.

  [Distinct Count](https://userguide.qualytics.io/data-quality-checks/distinct-count/introduction/)
- **Equal To Field**

  Asserts that this field is equal to another field.

  [Equal To Field](https://userguide.qualytics.io/data-quality-checks/equal-to-field/introduction/)
- **Exists In**

  Asserts that values assigned to this field exist as values in another field.

  [Exists In](https://userguide.qualytics.io/data-quality-checks/exists-in/introduction/)
- **Expected Values**

  Asserts that values are contained within a list of expected values.

  [Expected Values](https://userguide.qualytics.io/data-quality-checks/expected-values/introduction/)
- **Greater Than**

  Asserts that the field is a number greater than (or equal to) a value.

  [Greater Than](https://userguide.qualytics.io/data-quality-checks/greater-than/introduction/)
- **Greater Than Field**

  Asserts that this field is greater than another field.

  [Greater Than Field](https://userguide.qualytics.io/data-quality-checks/greater-than-field/introduction/)
- **Is Address**

  Asserts that the values are addresses of the required format.

  [Is Address](https://userguide.qualytics.io/data-quality-checks/is-address/introduction/)
- **Is Credit Card**

  Asserts that the values are credit card numbers.

  [Is Credit Card](https://userguide.qualytics.io/data-quality-checks/is-credit-card/introduction/)
- **Is Type**

  Asserts that the data is of a specific type.

  [Is Type](https://userguide.qualytics.io/data-quality-checks/is-type/introduction/)
- **Less Than**

  Asserts that the field is a number less than (or equal to) a value.

  [Less Than](https://userguide.qualytics.io/data-quality-checks/less-than/introduction/)
- **Less Than Field**

  Asserts that this field is less than another field.

  [Less Than Field](https://userguide.qualytics.io/data-quality-checks/less-than-field/introduction/)
- **Matches Pattern**

  Asserts that a field must match a pattern.

  [Matches Pattern](https://userguide.qualytics.io/data-quality-checks/matches-pattern/introduction/)
- **Max Length**

  Asserts that a string has a maximum length. On array fields, checks the array has at most N elements. With element context, checks each string element's length.

  [Max Length](https://userguide.qualytics.io/data-quality-checks/max-length/introduction/)
- **Max Value**

  Asserts that a field has a maximum value.

  [Max Value](https://userguide.qualytics.io/data-quality-checks/max-value/introduction/)
- **Min Length**

  Asserts that a string has a minimum length. On array fields, checks the array has at least N elements. With element context, checks each string element's length.

  [Min Length](https://userguide.qualytics.io/data-quality-checks/min-length/introduction/)
- **Min Value**

  Asserts that a field has a minimum value.

  [Min Value](https://userguide.qualytics.io/data-quality-checks/min-value/introduction/)
- **Not Empty**

  Asserts that a text or array field is not empty. A value made only of spaces counts as empty.

  [Not Empty](https://userguide.qualytics.io/data-quality-checks/not-empty/introduction/)
- **Not Exists In**

  Asserts that values assigned to this field do not exist as values in another field.

  [Not Exists In](https://userguide.qualytics.io/data-quality-checks/not-exists-in/introduction/)
- **Not Future**

  Asserts that the field's value is not in the future.

  [Not Future](https://userguide.qualytics.io/data-quality-checks/not-future/introduction/)
- **Not Negative**

  Asserts that this is a non-negative number.

  [Not Negative](https://userguide.qualytics.io/data-quality-checks/not-negative/introduction/)
- **Positive**

  Asserts that this is a positive number.

  [Positive](https://userguide.qualytics.io/data-quality-checks/positive/introduction/)
- **Predicted By**

  Asserts that the actual value of a field falls within an expected predicted range.

  [Predicted By](https://userguide.qualytics.io/data-quality-checks/predicted-by/introduction/)
- **Required Values**

  Asserts that all of the defined values must be present at least once within a field.

  [Required Values](https://userguide.qualytics.io/data-quality-checks/required-values/introduction/)
- **Sum**

  Asserts that the sum of a field is a specific amount.

  [Sum](https://userguide.qualytics.io/data-quality-checks/sum/introduction/)
- **Time Distribution Size**

  Asserts that the count of records for each interval of a timestamp is between two numbers.

  [Time Distribution Size](https://userguide.qualytics.io/data-quality-checks/time-distribution-size/introduction/)

### Multiple Fields

Rules that take one or more fields together, such as fields that must hold a value, unique keys, or a row-by-row comparison with another table.

- **Any Not Null**

  Asserts that at least one of the selected fields must hold a value.

  [Any Not Null](https://userguide.qualytics.io/data-quality-checks/any-not-null/introduction/)
- **Data Diff**

  Asserts that the dataset created by the targeted field(s) has differences compared to the referred field(s).

  [Data Diff](https://userguide.qualytics.io/data-quality-checks/data-diff/introduction/)
- **Equal To**

  Asserts that all of the selected fields equal a value.

  [Equal To](https://userguide.qualytics.io/data-quality-checks/equal-to/introduction/)
- **Is Replica Of**

  Deprecated. Replaced by **Data Diff**, which performs the same row-by-row comparison and adds change-type filtering.

  [Is Replica Of](https://userguide.qualytics.io/data-quality-checks/is-replica-of/introduction/)
- **Not Null**

  Asserts that the field's values are not null. On array fields with element context, asserts that no elements within the array are null.

  [Not Null](https://userguide.qualytics.io/data-quality-checks/not-null/introduction/)
- **Unique**

  Asserts that each field's value is unique across rows. When multiple fields are selected, asserts that the combination of values across those fields is unique (composite key).

  [Unique](https://userguide.qualytics.io/data-quality-checks/unique/introduction/)

### Calculated

Rules that evaluate an expression you write, compare two aggregations, or match records that describe the same entity.

- **Aggregation Comparison**

  Verifies that the specified comparison operator evaluates true when applied to the two aggregation expressions.

  [Aggregation Comparison](https://userguide.qualytics.io/data-quality-checks/aggregation-comparison/introduction/)
- **Entity Resolution**

  Asserts that records describing the same entity are clustered together, even when their values vary, and that every record in a cluster shares one value of a chosen distinction field.

  [Entity Resolution](https://userguide.qualytics.io/data-quality-checks/entity-resolution/introduction/)
- **Satisfies Expression**

  Evaluates a SQL expression you provide against every record.

  [Satisfies Expression](https://userguide.qualytics.io/data-quality-checks/satisfies-expression/introduction/)

### Aggregated

Rules that record a value on every Scan and watch how it changes.

- **Metric**

  Records the value of the selected field during each scan operation and asserts limits based upon an expected change or absolute range (inclusive).

  [Metric](https://userguide.qualytics.io/data-quality-checks/metric/introduction/)

### Metadata

Rules about the table or file as a whole: how recent it is and how many records it holds.

- **Freshness**

  Asserts that the data was added or updated within a maximum allowed age.

  [Freshness](https://userguide.qualytics.io/data-quality-checks/freshness/introduction/)
- **Volumetric**

  Asserts that the row count of a table or file stays within an expected range, or changes by no more than expected since an earlier day.

  [Volumetric](https://userguide.qualytics.io/data-quality-checks/volumetric/introduction/)

### Schema

Rules about the structure of the table or file rather than the values inside it.

- **Expected Schema**

  Asserts that all selected fields are present and that all declared data types match expectations.

  [Expected Schema](https://userguide.qualytics.io/data-quality-checks/expected-schema/introduction/)
- **Field Count**

  Asserts that there must be exactly a specified number of fields.

  [Field Count](https://userguide.qualytics.io/data-quality-checks/field-count/introduction/)
- **Max Partition Size**

  Asserts the maximum number of records that should be loaded from each file or table partition.

  [Max Partition Size](https://userguide.qualytics.io/data-quality-checks/max-partition-size/introduction/)
- **Min Partition Size**

  Asserts the minimum number of records that should be loaded from each file or table partition.

  [Min Partition Size](https://userguide.qualytics.io/data-quality-checks/min-partition-size/introduction/)

---

## API & FAQ

- **Checks API**

  Endpoints shared by every rule type: history, versions, insights, ownership, and AI Managed checks.

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

  Common questions about auditing checks, ownership, and AI Managed checks.

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

*Last updated: November 10, 2026.*
