Module History

Module History displays the revision history of a module. Creators use it to 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 the saved revisions of the module, grouped by date. The groups are Today, This Week, This Month, and then one for each earlier month. Each revision displays the save timestamp and the Creator who saved it. The active revision displays a blue dot indicator.

In a versioned application, the list displays the history of the open branch or version. That history includes the saves made there, plus the saves it shares with its parent version. Saves made to the same module in other branches aren't listed. Search and filters apply to that history.

When a Creator switches branches, the list reloads for the new branch and the selected and compared revisions clear. Search and filters stay in place. In an application without versioning, the list displays every save of the module.

Searching and Filtering

Revision Actions

Click (ellipsis) on any revision to access the following actions:

Action	Description
Star	Marks the revision as important for easy reference. Changes to Unstar on a starred revision.
Rename	Assigns a custom name to the 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 save	Replaces the current module with this revision. Not available on the current version.

Revision Detail

Selecting a revision opens its detail view in the right panel.

The header displays the revision name, the date and time the revision was saved, and the name of the Creator who saved it. Creators can mark the revision as important with the star icon in the detail view.

A notes field holds a summary for the revision. Creators use it to document what changed, reference a Jira ticket, or give context to other team members.

The panel also displays a preview of the module at that point in time.

Smart Component Definitions

When a module owns Private Smart Components, the detail view lists them in a Smart Component Definitions section. The Configuration section below it displays the module's component tree. Each entry displays the component's name and type, and a mark that compares it with the previous save:

Marks don't display when the previous save is unknown. The previous save is unknown while a search or save type filter is active, and for the oldest loaded revision.

Select a definition to open it read-only as it was in that save. A UI Smart Component opens with UI and Logic tabs. Other types open with the Logic tab only.

Revision Detail Actions

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 save from the ellipsis menu or 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. In the Edit Restore Details section, Creators can optionally update the restore name (prefilled 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 a Creator restores a save in 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 the Creator publishes.

• The confirmation modal lists the module's Private Smart Components under Restored with this revision. The list has no checkboxes because Private components 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 display under Also roll back Public Smart Components. Rolling back a Public Smart Component changes it for every module that uses it.

Restoring Private Smart Components requires permission to edit them. Without that permission, the restore doesn't run. If someone else saves the module in the draft during the restore, the restore stops, and the Creator must reload and try again.

Comparing Revisions

Click Compare versions at the top of the left panel or select Compare to... from a revision's ellipsis menu. Either action opens a side-by-side view of two revisions. Use the comparison to identify what changed between saves.

The comparison also lists Private Smart Components whose definitions changed between the two revisions. The All Edits, Added, and Deleted filter tabs count them. The comparison reads No differences between these versions. only when neither the configuration nor a definition changed.