collab.spaceDocumentation

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.

Navigating Version History

Use the version navigation buttons in the toolbar:

  • Undo Version (arrow left) - Step back to the previous saved version
  • Redo Version (arrow right) - Step forward to a newer version
  • History button - Open the Version History dialog to see all versions

When viewing a past version, a badge shows which version you're viewing.

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
  3. When the duplicate warning appears, choose Continue and Create New Versions

The new upload becomes the latest version, and previous versions remain accessible in the history.

Uploading from the Properties Panel

You can also upload a new version directly from the properties panel:

  1. Open the uploaded file
  2. In the Properties tab, find the Version History section
  3. Use the Upload New Version button

Viewing Version History

For both editor documents and uploaded files:

  1. Open the document or file
  2. Open the Properties tab in the right panel
  3. Expand the Version History section
  4. 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
  • Use the Activity section to add comments when uploading new versions
  • Reference specific versions when sharing with stakeholders
  • Use version history to track document evolution over time

Next Steps