Version control

Files, pages, and wikis in your digital workplace support version control. When you update these objects' content, you create a new version of the object that replaces but does not delete the existing version. While the most recent version of an object is always visible to members, past versions can be accessed and viewed by those with sufficient access.

Go to one of the following sections in this article: 

Considerations

  • URLs: When you create a new version of a file, page, or wiki, its URL does not change. 
  • Trash Can recovery: Recovered files, pages, and wikis keep their previous version history. However, the most recent version's timestamp will be changed to when you recovered the object. 
  • Storage: Past versions do not contribute to your digital workplace's storage space.
  • Version limit: A file or wiki article can have up to 32,767 versions.

File versioning

A file's version number is shown above its preview.

The current version number of a file.

Actions that create new file versions

  • Uploading a new version
  • Editing the title
  • Selecting Save on the Edit page; however, only these properties are version-specific:
    • Title
    • Description
    • Read Tracking is enabled or disabled
    • Read Tracking button text

Interact with a file's versions

Add a new version to a file.

If you have at least Write access to a file, you can access its Versions page by selecting the version number (e.g. v.3) or by selecting  Actions followed by Versions.

While on the Versions page, you can:

  • Download file: Select next to the file size to download that version of the file. This requires at least Write access.
  • Create New Version: Select to make a new version with the same file, title, description, and read tracking settings (enabled/disabled and button text) as the selected version. This is only available to workplace or enterprise administrators and space administrators if the file is in their space.
  • Delete File Version: Select to delete a version. This option is only available to enterprise or workplace administrators.
  • Recover File Version: Select to recover a deleted version. A deleted file version will remain available for recovery for 30 days after deletion. This option is only available to enterprise or workplace administrators.
  • Upload New File Versions:
    • Select Select files from your computer to upload a new version of the file. This requires at least Write access. 
    • Drag your file into the designated area to upload a new version of the file. This requires at least Write access. 

Files can also be interacted with using the File Manager.

File versions and archiving

Archived files display their most recent version. However, past versions can be downloaded from the Versions page if you have at least Write access to the file.

File versions and read tracking

While the button text and whether read tracking is turned on are unique to each version, the tracked read status does not differentiate between versions. 

File versions and drafts

Files in a draft state do not have versioning.

Page versioning

A Page's version history is visible while editing it. Unlike files and wikis, pages include drafts in their version history. This also applies to the Home location of a space that functions like a page.

Actions that create new page versions

  • Editing the title
  • Selecting Publish Page or Save as Draft on the Edit page; however, only these properties are version-specific:
    • Title
    • Widgets and their configurations (an exception to this is the Poll widget; poll data, questions, and responses will always show what their most current values are)

Interact with a page's versions

A page's version history.

When editing a Page (at least Edit access is required), scroll down to the bottom of it and select Version History to view a list of draft and past versions. You can then select a version to display it in the editor. The current published version of a page will always display under the Published Version heading. However, be aware that the Published Version does not have a version number and will only get a version number when it becomes a Past Version. 

While viewing a Draft Version or Past Version, you can make changes or revert to the published version (using the link at the top of the Edit page). If you are unsure what version you are viewing, you can open Version History and look for the entry that has parentheses around the version number. 

To save your changes, you must either publish them (select Publish Page) or save them as a draft (select Save as Draft). Publishing will create a new Published Version and cause the previous Published Version to become a Past Version with a version number while saving as a draft will create a new Draft Version. 

Draft Versions are displayed in Version History under the Recent Drafts heading until a new version of the Page is published. At this time, the Draft Versions are moved under Past Versions and are labeled as drafts to differentiate them from published versions.

Pages with an unpublished Draft Version will display the Draft Version when edited, not the most recent Published Version.

Page versions and templates

Page templates use the Published Version of a page; they are not specific to the version in which the page was made a template.

Wiki versioning

A wiki article's version number is visible in its information panel. Similar to files and pages, you can compare past versions of wiki articles and can revert to a previous wiki version.

The current version of a wiki article.

Actions that create new wiki versions

  • Editing the title
  • Selecting Save Changes on the Edit page; however, only the article's content (what's in the WYSIWYG editor) is considered when you compare versions.

Interact with a wiki's versions

Comparing wiki versions.

If you have at least Write access to a wiki article, you can access previous versions by:

  • Selecting the version number (e.g., v.4)
  • Selecting  Actions followed by Versions
  • Selecting Last Updated to view a comparison of the two most recent article versions.

While on the Versions page, you can select two versions and then select Compare selected versions to see what changed between the versions. 

The results of comparing two version of a wiki article.

While viewing a comparison of versions, changes are indicated in the following ways:

  • New text is highlighted in green
  • Removed text has a strike through it

If there are no changes, a message indicating "No difference found" appears at the top of the article.

You can make additional comparisons by:

  • Selecting two versions from the side panel and then selecting Compare.
  • Selecting Previous Change, Next Change, or Last Change to cycle through the version history.

To revert to a previous wiki version:

  1. While viewing a wiki article, select its version number.
  2. On the Versions page, select Compare selected versions.
  3. In the Versions panel, select the date that corresponds to the version that you want to revert to.
  4. Above the article, select Revert to this version.
  5. Select OK.

Wiki versions and archiving

Archived wikis display their most recent version. You can still perform comparisons between the versions of an archived article.

Wiki versions and read tracking

The tracked read status does not differentiate between versions. 

Wiki versions and drafts

Wikis in a draft state support versioning and version comparison. When published, this draft version history is lost, and the published version begins at version 1.