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. |
| Preview in Express | Opens a preview of the module at this revision in Express. |
| 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 | Creates a copy of the module at this revision. |
| Preview | Opens a preview of the module at this revision in Express. |
| 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 path
- 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.
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-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 (UQE-15867). |
| — | Initial publication. |