---
title: Remove a mapping
description: Remove a PingIDM synchronization mapping by deleting it from sync.json or using the admin UI, and understand how links are handled in each case
component: pingidm
version: 8
page_id: pingidm:synchronization-guide:remove-sync-mapping
canonical_url: https://docs.pingidentity.com/pingidm/8.1/synchronization-guide/remove-sync-mapping.html
llms_txt: https://docs.pingidentity.com/pingidm/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["Synchronization", "Resource", "Mappings"]
superseded_by: https://docs.pingidentity.com/pingidm/8.1/synchronization-guide/remove-sync-mapping.html
---

# Remove a mapping

* To remove a mapping, delete the corresponding section from your mapping configuration *(tooltip: You can manage the mapping configuration over REST at the config/sync endpoint, directly in the conf/sync.json file, or in individual conf/mapping-\<mappingName>.json files.)*. If you have configured mappings in individual mapping files, delete the file associated with the mapping you want to remove.

* To remove a mapping using the admin UI, select Configure > Mappings, and then click Delete under the mapping to remove.

|   |                                                                                                                                                                                                                                                      |
| - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | If you delete a mapping using the admin UI, the `delete-mapping-links` script removes all links related to that mapping from the repository. If you delete the mapping directly in the configuration file, no links are deleted from the repository. |