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
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.
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.
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.
Related Topics
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
