Skip to main content

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.
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 and permission dependencies.

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.
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 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.
  • Only recorded versions can be restored. Changes made before change history was available aren’t in the history.
  • Syncs are recorded too. A sync writes a new version in the target, so you can revert it the same way.

Resetting an Entity

Return an entity to its default state

Data Mapping Editor

Edit and save an entity’s mapping

Sync Overview

Copy mappings between pipelines

Publishing Mappings

Put a restored mapping into production