Module History displays the full revision history of a module and lets Creators review previous versions, compare changes, and restore an earlier state if needed.
Access Module History by selecting Definition in the Module Builder toolbar, then choosing History from the drop-down.
Revision List
The left panel displays all saved revisions of the module, grouped by month. Each revision displays the save timestamp and the Creator who saved it. The active revision displays a blue dot indicator.
Searching and Filtering
| Control | Description |
|---|---|
| Search | Filters revisions by keyword. |
| Show all save types | Filters the list by revision type. Options include: All save types, Starred, Promoted, Restored, Named, and Contains Notes. |
| Date range | Filters the list by time period. Options include: All Time, Today, Past Week, Past Month, and a custom date picker for specific dates or ranges. |
Revision Actions
Click the ellipsis menu on any revision to access the following actions:
| Action | Description |
|---|---|
| Add star | Marks the revision as important for easy reference. |
| Rename | Assigns a custom name to the revision. |
| Copy this version | Creates a copy of the module at this revision. |
| Compare to... | Opens a side-by-side comparison between this revision and another. |
| View in Express | Opens a preview of the module at this revision in Express. A revision is a snapshot of the module alone, so it opens without the application shell. |
| Restore this version | Replaces the current module with this revision. |
Revision Detail
Selecting a revision opens its detail view in the right panel.
The header displays the revision timestamp and a label indicating how the revision was created: Current by for the active version, Saved by for a standard save, or Restored by for a version that was previously restored. A star icon lets Creators mark the revision as important directly from the detail view.
A notes field lets Creators add a summary for the revision, useful for documenting what changed, referencing a Jira ticket, or providing context for other team members.
The panel also displays a preview of the module at that point in time.
| Action | Description |
|---|---|
| Copy this save | Saves this revision as a new library module. |
| Restore this save | Replaces the current module with this revision. Not available on the current version. |
Restoring a Save
Selecting Restore this version from the ellipsis menu or Restore this save from the revision detail panel opens a confirmation modal.
What gets restored includes the following:
- Components
- Module title and
- Module settings
What does not change includes the following:
- Transforms
- Reference data, including Data Collections
Notes transfer over to the restored version unless edited before confirming. The Edit Restore Details section lets Creators optionally update the restore name (pre-filled with "(Restored) [timestamp]") and add notes before completing the restore.
Click Yes, Restore to confirm or No, Don't Restore to cancel.
Restoring in an Application Draft
When you restore a save inside an application draft, the module's private Smart Components come back as they were in that save. The change applies to that draft only. Published versions and other drafts keep their current versions until you publish.
- The confirmation modal lists these components under Restored with this module. They have no checkbox because they always come back with the module.
- A private Smart Component with no saved version in that save keeps its current version in the draft.
- A private Smart Component that was deleted, or that another module now owns, cannot come back. The restore still completes, and a message names how many components could not be rolled back.
- Public Smart Components still appear under Also roll back Public Smart Components. Rolling one back changes it for every module that uses it.
Restoring private Smart Components requires permission to edit them. If you do not have it, the restore does not run. If someone else saves the module in the draft while you restore, the restore stops and asks you to reload and try again.
Comparing Revisions
Click Compare at the top of the left panel, or select Compare to... from a revision's ellipsis menu, to open a side-by-side view of two revisions. Use the comparison to identify what changed between saves.
Changelog
| Date | Change |
|---|---|
| 2026-10-06 | Added Restoring in an Application Draft: private Smart Components come back with the module in a draft. |
| 2026-08-21 | Revision action renamed Preview in Express → View in Express. Revision Detail actions corrected to Restore this save and Copy this save; removed a Preview row for an action the panel does not have. |
| 2026-07-01 | Updated access path: Definition dropdown → History (was: ellipsis menu → Module History). |
| 2026-06-29 | Removed "not yet available" callout — Module History shipped in PR #7592. |
| — | Initial publication. |