> ## 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.

# Change History and Revert

> See every saved change to an entity or pipeline mapping and restore an earlier version

## Overview

Every time an entity's mapping is saved, synced, reset, or reverted, a version is recorded in its change history. You can review those versions, preview an earlier one, and restore it.

> [!NOTE]
>
> **Required permissions**
>
> * **Manage Production Pipelines** or **Manage Dev Pipelines**: Read to view history, Update to revert
> * **Manage Silver Entities** or **Manage Gold Entities**, for the entity's layer: Read to view history, Update to revert an entity
>
> Without Update, **Revert** is shown but disabled. See [roles and permissions](https://support.entegrata.com/administration/user/roles-and-permissions.md#feature-reference) and [permission dependencies](https://support.entegrata.com/administration/user/permission-dependencies.md).

## Opening Change History

Click **History** at the top of the page:

* **On an entity**, the panel shows that entity's history.
* **On a pipeline's entity list**, the panel shows the history of the whole pipeline.

Each entry shows the action, when it happened, who made it, and the reason they gave.

## Previewing a Version

Click **Preview** on an entry to open a read-only copy of the entity as it was at that point. You can browse its **Editor** and **Fields** tabs but not change them.

## Reverting an Entity

**1. Find the Version**

In the entity's history, find the version you want to go back to. The most recent entry is the current mapping, so it has no **Revert** button.

**2. Select Revert**

Click **Revert** on that entry, or **Revert to this version** from its preview.

**3. Give a Reason**

Enter a reason for the revert. It's required and saved to the change history.

**4. Confirm**

Click **Revert entity**. The entity's mapping is restored, and a new entry is added to its history.

> [!NOTE]
>
> Reverting adds a new version instead of removing the later ones. Later changes stay in the history, so you can revert a revert.

## Reverting a Whole Pipeline

**1. Open the Pipeline's History**

Open the pipeline's entity list and click **History**.

**2. Pick the Entry**

Click **Revert Pipeline to Here** on the entry you want to go back to.

**3. Give a Reason and Confirm**

Enter a reason and click **Revert Pipeline**.

Every entity goes back to its most recent version at or before that entry. Entities with no version from that period are left as they are. The result lists each entity as **Reverted** or **Skipped**, and each reverted entity gets a new history entry.

## Undoing a Reset

A [reset](https://support.entegrata.com/data/pipeline/resetting-entities.md) is recorded in history as **Reset**. That entry stores the entity as it was after the reset, so to undo it, revert to the next older entry.

## Things to Know

* **Reverting doesn't publish.** Your running pipeline keeps using the last published mapping until you publish again. See [Publishing Mappings](https://support.entegrata.com/data/pipeline/publishing-mappings.md).
* **Only recorded versions can be restored.** Changes made before change history was available aren't in the history.
* **Syncs are recorded too.** A [sync](https://support.entegrata.com/data/pipeline/sync-overview.md) writes a new version in the target, so you can revert it the same way.

## Related Topics

> [card] [Resetting an Entity](https://support.entegrata.com/data/pipeline/resetting-entities.md)
>
> Return an entity to its default state

> [card] [Data Mapping Editor](https://support.entegrata.com/data/pipeline/data-mapping-editor.md)
>
> Edit and save an entity's mapping

> [card] [Sync Overview](https://support.entegrata.com/data/pipeline/sync-overview.md)
>
> Copy mappings between pipelines

> [card] [Publishing Mappings](https://support.entegrata.com/data/pipeline/publishing-mappings.md)
>
> Put a restored mapping into production


## Related topics

- [Resetting an Entity](https://support.entegrata.com/data/pipeline/resetting-entities.md)
- [Versioned History](https://support.entegrata.com/data/collector/resources/versioned-history.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.