OmadaDocumentation

Version Control

Track changes and maintain history for both editor documents and uploaded files.

The Documents app provides version control for all content types. Editor documents use snapshot-based versioning with commit messages, while uploaded files create new versions automatically when you upload a file with the same name.

Editor Documents

Saving Versions

Editor documents use snapshot-based version control. To save a version:

  1. Click the Save button in the toolbar (or press Ctrl+S)
  2. Enter a commit message describing your changes (optional)
  3. Click Save Version

Each save creates a new version entry in the version history.

Restoring a Previous Version

To roll back to an earlier snapshot:

  1. Open the History tab in the right panel
  2. Find the version you want in the list
  3. Click Restore on that version to make it the current content

You can also open the same list from the floating toolbar's More actions (…) menu via Version history. There are no undo/redo version-stepping arrows in the toolbar — you always restore a specific version directly.

Discarding Unsaved Changes

If you have unsaved changes you want to discard:

  1. Click the Discard button in the toolbar (appears when you have unsaved changes)
  2. Confirm the action

Your document reverts to the most recently saved version.

Uploaded Files

Creating New Versions

Upload a file with the same name to the same folder to create a new version automatically:

  1. Click the + button and select Upload Files
  2. Upload a file with the same name as an existing file

The new upload silently becomes the latest version — there is no confirmation dialog. Previous versions remain accessible in the history.

Uploading a New Version from the Toolbar

You can also upload a new version directly from an open file:

  1. Open the uploaded file
  2. Click the More actions (…) menu in the floating toolbar
  3. Choose Upload new version and pick the file

Viewing Version History

For both editor documents and uploaded files:

  1. Open the document or file
  2. Open the History tab in the right panel
  3. See all versions listed with their details

Version Information

FieldEditor DocumentsUploaded Files
Version NumberSequential identifier (v1, v2, v3...)Sequential identifier (Version 1, 2...)
Created DateWhen the version was savedWhen the version was uploaded
AuthorTeam member who saved the versionTeam member who uploaded the file
MessageCommit message describing changes--
File Size--Size of that specific version

Best Practices

  • For editor documents, save versions at meaningful checkpoints with descriptive commit messages
  • For uploaded files, upload with the same filename to maintain a clean version chain rather than creating separate files
  • Reference specific versions when sharing with stakeholders
  • Use version history to track document evolution over time

Next Steps