Managing File Revisions

When you edit a BarTender document that you created using a template, edit a document in BarTender Cloud Designer, or upload a document or support file that overwrites an existing document or support file, you create a new revision of that file. You can view a file's revision history by using the Revision History page. On this page, you can view and compare the revisions of a selected BarTender document. You can also add comments to a file revision and roll back to a previous revision.

To open the Revision History page

  1. Click to open the BarTender Cloud menu, then click Librarian. Alternatively, you can click the Librarian button on the Home page.

  2. In the Space list, select the space where the document is located, if applicable.

  3. In the item list pane, select the file whose revision history you want to view.

  4. Click History on the toolbar. Alternatively, right-click the file or click , then select History.

In the Revision column on the Librarian page, you can also click the revision number of the file whose revision history you want to view, if it is a live link, to open a dialog that displays the file's entire revision history. In this dialog click and choose History to open the Revision History page.

The Revision History page includes a Revisions pane on the left side that lists the revisions and a details pane on the right side that lists the details for the selected revision. The details pane also includes a toolbar that provides the following options:

  • Add Comment: Opens the Revision Comment dialog where you can add a comment to the selected revision.

  • View Revision Image: Opens the Revision dialog that displays an image of the selected revision. Available for BarTender documents.

  • Rollback Revision: Opens the Rollback File dialog so that you can roll the file back to the selected revision. Available when the selected revision is not the current revision.

  • Hide/Show Comments: Hides or shows all comments for all revisions.

  • Compare Revisions: Displays the selected revision next to the revision that you want to compare to, and provides a colored display of the differences between the two revisions. Available for BarTender documents.

ClosedTo add a comment to a file in Librarian

  1. In the item list pane of Librarian, select the file that you want to add comments to.

  2. On the toolbar, click Comment. Alternatively, right-click the file or click , then select Comment.

  3. In the Revision Comment dialog, enter the comment, then click Add. The comment is displayed in the file's revision history.

ClosedTo add a comment to a revision on the Revision History page

  1. In the Revisions pane, select the revision you want to add the comment to, then click Add Comment.

  2. In the Revision Comment dialog, enter a comment, then click Add.  

ClosedTo hide or show all comments

  • On the Revision History page, click Hide Comments if the comments are shown or Show Comments if they are hidden. All the comments for all the revisions are hidden or shown.

ClosedTo view a file's revision history

  1. In the item list pane in Librarian, select the file that you want to view.

  2. On the toolbar, click History. Alternatively, right-click the file or click , then click History.

  3. In the left pane of the Revision History page, click the revision whose details you want to view. By default, the most recent revision's details are displayed when you open this page.

ClosedTo view an image of a revision

  • In the Revisions pane of the Revision History page, select the revision that you want to view, then click View Revision Image. Available for BarTender documents.

ClosedTo roll back a revision

  1. In the Revisions pane of the Revision History page, select the revision that you want to roll back to, then click Rollback Revision.

  2. In the Rollback File dialog, verify the file name and the revision that you are rolling back to and optionally add a comment in the Comment area

  3. Click OK. The rolled-back revision is displayed in the Revisions pane as a new current revision.

ClosedTo compare revisions

Revision comparison is available only for BarTender documents.

  1. In the Revisions pane of the Revision History page, select the revision that you want to use to compare, then click Compare Revisions.

  2. In the Compare this revision to list, select the revision you want to compare the selected revision to. The page that is displayed shows the two revisions side by side in the Comparing and To areas. The Differences area displays a merged version with the differences highlighted in color.

  3. To return to the Revision History page, click Back.

ClosedTo return to Librarian

  • On the Revision History page, click Close.