# Getting Started with the Entity Resolution Recipe

Source: https://userguide.qualytics.io/recipes/entity-resolution/getting-started/

*Requires the Data Quality (DQ) module.*

*Requires the Master Data Management (MDM) module.*

The Entity Resolution recipe takes a profiled table from suspected duplicates to a deduplicated golden set in your enrichment destination. It runs in two phases. **Build & Validate** configures an Entity Resolution check and dry-runs it on a sample. **Scan & Remediate** scans every record, lets you pick the golden record for each entity, and writes the golden set.

Two things must be in place before the recipe can run end to end:

- The table must be **profiled**. Only profiled tables are offered when you select the asset.
- The source datastore must have a **linked enrichment destination** before the Scan step. The recipe blocks in place and offers to link one when it is missing.

The Deep Dive pages explain how the recipe works, what each step does, and how existing checks and anomalies enter the flow. The How-tos walk through each task step by step, and the Troubleshooting, API, and FAQ pages cover the rest.

> **Info: Permissions**
>
> Anyone can open the recipe and browse its steps. Creating the check needs the **Drafter** team permission on the source datastore. Validating it (the dry run followed by activation) needs **Author**, and running the scan and writing the golden set need **Editor**. See [Permissions](https://userguide.qualytics.io/recipes/entity-resolution/deep-dive/permissions/) for the full matrix.

---

## Deep Dive

Understand what the recipe is, how each phase works, and who can do what.

- **Introduction**

  What the recipe is, the two phases, and what it produces.

  [Introduction](https://userguide.qualytics.io/recipes/entity-resolution/deep-dive/introduction/)
- **How It Works**

  The phases, the two prerequisites, what the run reads and writes, and AgentQ's role.

  [How It Works](https://userguide.qualytics.io/recipes/entity-resolution/deep-dive/how-it-works/)
- **Build and Validate**

  Select Asset, Distinction Field, Compare Fields, Match Threshold, Review, and Validate, step by step.

  [Build and Validate](https://userguide.qualytics.io/recipes/entity-resolution/deep-dive/build-and-validate/)
- **Scan and Remediate**

  The full scan, choosing golden records, writing the golden set, and the completion summary.

  [Scan and Remediate](https://userguide.qualytics.io/recipes/entity-resolution/deep-dive/scan-and-remediate/)
- **Entry Points and Resuming**

  Open in Recipe, Scan in Recipe, Remediate in Recipe, and how progress is kept between visits.

  [Entry Points and Resuming](https://userguide.qualytics.io/recipes/entity-resolution/deep-dive/entry-points/)
- **Examples**

  Real scenarios showing the recipe taking a table from suspected duplicates to a golden set.

  [Examples](https://userguide.qualytics.io/recipes/entity-resolution/deep-dive/examples/)
- **Best Practices**

  Guidelines for preparing the asset, choosing fields, tuning the threshold, and remediating.

  [Best Practices](https://userguide.qualytics.io/recipes/entity-resolution/deep-dive/best-practices/)
- **Permissions**

  The roles and team permissions behind each step of the recipe.

  [Permissions](https://userguide.qualytics.io/recipes/entity-resolution/deep-dive/permissions/)

---

## How-tos

Run the recipe and enter it from existing work, step by step.

- **Run the Entity Resolution Recipe**

  Go from the Recipes page to a written golden set.

  [Run the Recipe](https://userguide.qualytics.io/recipes/entity-resolution/how-tos/run-recipe/)
- **Open a Check in the Recipe**

  Load an Entity Resolution check that is not active yet into the Review step.

  [Open a Check](https://userguide.qualytics.io/recipes/entity-resolution/how-tos/open-check-in-recipe/)
- **Scan a Check in the Recipe**

  Take an active Entity Resolution check straight to the Scan step.

  [Scan a Check](https://userguide.qualytics.io/recipes/entity-resolution/how-tos/scan-in-recipe/)
- **Remediate an Anomaly in the Recipe**

  Open an Entity Resolution anomaly at the Remediate step with its records loaded.

  [Remediate an Anomaly](https://userguide.qualytics.io/recipes/entity-resolution/how-tos/remediate-in-recipe/)
- **Link an Enrichment Destination from the Scan Step**

  Link the enrichment destination the recipe needs without leaving the flow.

  [Link an Enrichment Destination](https://userguide.qualytics.io/recipes/entity-resolution/how-tos/link-enrichment/)
- **Resume or Start Over**

  Continue where you left off, or clear your progress and begin again.

  [Resume or Start Over](https://userguide.qualytics.io/recipes/entity-resolution/how-tos/resume-or-start-over/)

---

## Troubleshooting, API and FAQ

- **Troubleshooting**

  Known problems while selecting, validating, scanning, remediating, and materializing, and how to resolve them.

  [Troubleshooting](https://userguide.qualytics.io/recipes/entity-resolution/troubleshooting/)
- **API**

  The sequence of calls behind the recipe, and the AI assist endpoints it uses.

  [API](https://userguide.qualytics.io/recipes/entity-resolution/api/)
- **FAQ**

  Common questions about the rule type, prerequisites, outputs, AgentQ, and resuming.

  [FAQ](https://userguide.qualytics.io/recipes/entity-resolution/faq/)

*Last updated: October 19, 2026.*
