> ## Documentation Index > Fetch the complete documentation index at: https://support.entegrata.com/llms.txt > Use this file to discover all available pages before exploring further. # Automap in the Mapping Editor > Run Automap on a data type in the mapping editor, then review, accept, and save its suggestions ## Overview The **Automap** button in the mapping editor generates suggestions for every map of the data type you have open. It applies the strongest suggestions for you and leaves the rest for you to review. To learn how suggestions are rated, see the [Automap Overview](https://support.entegrata.com/data/pipeline/automap-overview.md). > [!NOTE] > > **Required permissions** > > * **Data Pipelines**: Access > * **Manage Silver Entities**: Update > * **Manage Production Pipelines** or **Manage Dev Pipelines**, for the pipeline: Update > > Without these, the **Automap** button doesn't appear. See [roles and permissions](https://support.entegrata.com/administration/user/roles-and-permissions.md#feature-reference). ## Run Automap **1. Open the data type** Open the pipeline, then open the data type in the [mapping editor](https://support.entegrata.com/data/pipeline/data-mapping-editor.md). **2. Click Automap** Click the floating **Automap** button. While it works, the button reads **Mapping...**. **3. Read the summary** A summary message reports what Automap did, for example: > Loaded 2 maps, 1 new. Review and save to apply. The summary also lists any maps that need your attention: * **need a manual choice**: Automap found more than one reasonable option * **need a primary source**: pick one, as described below * **left unchanged — no match found**: Automap had no confident suggestions for the map * **skipped as duplicates**: a suggested new map would have duplicated an existing one ![Mapping editor after Automap runs, with the Automap and Review buttons and the summary message](https://mintcdn.com/entegrata/TpvgrAx_WL1xNLct/images/pipelines/automap_editor_summary.png?fit=max\&auto=format\&n=TpvgrAx_WL1xNLct\&q=85\&s=5beb3193ce83a56a20d770a59df7469d) **4. Review and save** Review the remaining suggestions (see [Review Suggestions](#review-suggestions)), then click **Save**. Automap works on every map of the data type, not just the one on the canvas: * **The map on the canvas** gets its suggestions applied directly, so you can see them. * **Other existing maps** are updated in the background and saved as unsaved local changes. Switch to each map to check it before you save. * **New maps** are added when Automap finds a source pattern that none of your maps cover. They stay previews until you save. > [!TIP] > > If Automap reports that no primary source is set up for this data type, browse the [source catalog](https://support.entegrata.com/data/pipeline/configuring-sources.md) and choose one yourself, or map the data type by hand. If Automap adds a primary source but can't tell which columns identify a record, **Configure Primary Source** opens. Under **Primary Key Fields**, select one or more fields that uniquely identify each record, then click **Confirm**. The primary key is also used as the identifier. ## Configure Joins Sometimes a suggestion maps a field from a table that isn't on the canvas yet. If Automap found a high-confidence join path for that table, it adds the table as a related source and joins it for you. If it didn't, **Configure Source Join** opens. When there are several joins to set up, the title counts them, for example **(1 of 3)**. **1. Choose a join path** If Automap found several possible paths, select the one that best fits your data. **2. Fill in the join fields** Set **Primary Key Fields**, **Source Identifier Field**, **Join To**, and **Target Identifier Field**. See [Configuring Sources](https://support.entegrata.com/data/pipeline/configuring-sources.md) for how identifiers and joins work. **3. Confirm or skip** Click **Confirm Join** to add the related source, or **Skip** to leave the field unmapped for now. ## Review Suggestions Click **Review** next to **Automap** to open **Automap Details**. It has two tabs: > [tab] Suggested > > Every field that still has suggestions, with its top candidate. Narrow the list with the band chips (**high**, **medium**, **low**) or the **Filter by field name...** box. > > * Click the check button on a row to accept its top suggestion. > * Click a row to see every candidate for that field, ranked, with the first marked **Top pick**. Each candidate shows its confidence, contributing signals, and any comments. Accept one, or click **X** to dismiss it. > > Row badges flag suggestions that need a closer look: **Has a relevant join suggestion** and **See comment for details**. > > ![Automap Details, Suggested tab, with band chips and suggestion rows](https://mintcdn.com/entegrata/TpvgrAx_WL1xNLct/images/pipelines/automap_details_suggested.png?fit=max\&auto=format\&n=TpvgrAx_WL1xNLct\&q=85\&s=58fc9e2a0f48cec17735818b07451c88) > > ![One field's ranked candidates, with the Top pick and its providers expanded](https://mintcdn.com/entegrata/TpvgrAx_WL1xNLct/images/pipelines/automap_field_candidates.png?fit=max\&auto=format\&n=TpvgrAx_WL1xNLct\&q=85\&s=e6cfd8c845a72be70665009f13b09735) > [tab] Applied > > Every suggestion that has been applied, whether you accepted it or Automap applied it for you. Click **Revert** to undo a single mapping. There's no "accept all" action. Accept suggestions one field at a time, so that each mapping gets a look. ### Table Filter Suggestions If table filter suggestions are enabled for your instance, they show up in **Automap Details** and in the **Filters** tab of the source's edit modal. Each one shows the **Current:** and **Suggested:** filter. * **Accept** applies the suggested filter. * **Edit** applies it and opens the source's **Filters** tab so you can adjust it. * **Dismiss** hides the suggestion. If the source already has a filter, accepting asks you to confirm in **Replace filter for \?**. See [source filters](https://support.entegrata.com/data/pipeline/configuring-sources.md) for how filters work. ## Saving Your Work Every suggestion that Automap applies or you accept is an unsaved edit on the canvas: * The save bar appears, the same as for manual edits. Click **Save** to write the changes to the pipeline, or **Discard** to drop them. * **Undo** (Ctrl+Z) and **Redo** (Ctrl+Shift+Z) next to **Automap** step through accepts, dismissals, reverts, automatic applies, and filter changes, up to 50 steps. * Saved mappings behave like any other mapping. [Publish](https://support.entegrata.com/data/pipeline/publishing-mappings.md) and [deploy](https://support.entegrata.com/data/pipeline/deploying-pipelines.md) them as usual. If you leave the editor without saving, your Automap review is kept in your browser. When you return to the same map, your suggestions, accepts, and dismissals come back. Undo history doesn't carry over. Saving or discarding clears the stored review, and so does a change to the map made somewhere else. ## Troubleshooting ### The Automap Button Is Missing * Check that your role has Update on **Manage Silver Entities** and on this pipeline. * Automap works on silver data types only. ### No Suggestions Found * Every active field on the data type may already be mapped. * The source tables may not be in your catalog yet. [Enable the resources](https://support.entegrata.com/data/collector/resources/enabling-resources.md) and run a collection, then try again. * Automap may have found no confident primary source. Add one from the [source catalog](https://support.entegrata.com/data/pipeline/configuring-sources.md), then run **Automap** again. ### A Suggestion Is Wrong Click **Revert** on the **Applied** tab, or use **Undo**. Then map the field by hand. See [Mapping Fields](https://support.entegrata.com/data/pipeline/mapping-fields.md). ## Related Topics > [card] [Automap Overview](https://support.entegrata.com/data/pipeline/automap-overview.md) > > How suggestions are rated and applied > [card] [Automap a Pipeline](https://support.entegrata.com/data/pipeline/automap-pipeline.md) > > Step through every unmapped data type in a pipeline > [card] [Data Mapping Editor](https://support.entegrata.com/data/pipeline/data-mapping-editor.md) > > The visual mapping editor > [card] [Configuring Sources](https://support.entegrata.com/data/pipeline/configuring-sources.md) > > Primary sources, related sources, and joins ## Related topics - [Automap a Pipeline](https://support.entegrata.com/data/pipeline/automap-pipeline.md) - [Automap Overview](https://support.entegrata.com/data/pipeline/automap-overview.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.