# Version control and document comparison

> [HTML Version](docs-versions.html)

BRIX supports document version control. Users can add a new version to a document created earlier.

Each document version is assigned one of the following statuses:

- **Current**. The active version that all users see when they open the document. You can send this version for approval or review.

- **Draft**. A version saved for further work. It does not become the current version until you explicitly mark it as current.

- **Outdated**. A version replaced by a new version. You can move it to the list of drafts, edit it, and then make it current.

- **Deleted**. A version moved to the list of deleted versions. You can restore it or delete it permanently.

All versions are shown on the sidebar of the document [view page](360009671252.md#view) in the [Document Versions](document-version.md) widget. You can view the list, compare the versions, and replace the current version with any of the previous ones.

Please note that version comparison is available only for .doc and .docx files if you have an integration with an office suite. The integration also allows you to edit document versions online.

Only a user with editing permissions for the app item can add a new version.

**Note**: In the [Document Versions](document-version.md#system-tab) widget settings, the system administrator can enable the **Read only > Yes** option. This prevents users from editing the current version or adding new ones.



## Add version

There are several ways to add a new version:

1. Click on the **(hmfile_hash_55f71cca.png) **button at the top of the document page and upload the new version of the file. If necessary, specify what changes were made in the **Comment** field.  
  
With this method, you can add a version as a draft that you can [edit](360027203731.md), and then make it the current version for further collaboration on the document. To do this, turn off the **Set the new version as the current one** option.

2. Click the** Edit** button on the document page and modify the file attached to the document.

3. Make changes to the document in a business process by using a [script](360027203731.md). In this case, the new version will be generated automatically.

4. For **.doc** or **.docx** files, the system administrator can allow you to add a new version when you [compare two versions](360027203731.md).

Information about all added document versions is displayed on the sidebar of the app item.

**(loan_agreement_01.PNG)**

## List of versions and available actions

To view the full list of versions, click the **All Versions** link. In the window that opens, versions are organized into tabs: **All**, **Current**, **Outdated**, **Drafts**, and **Deleted**.

**(docs-versions-02.PNG)**

Depending on the version status, the following actions are available:

- Open a version in [view mode](#view) by clicking its name.

- Download a version to your computer by clicking the **(download-icon.png)**  icon next to it.

- Print a version by clicking the **(print-icon.png)** icon. If [watermark printing](print-form-settings.md) is enabled for an app, the watermark will appear in the document.

- Delete a outdated version or draft by clicking the trash icon. The version will move to the **Deleted** tab. Version numbers will not change.

- Make a outdated version or draft current by clicking **Make Current**. The version will move to the **Current** tab. Version numbers will not change.  
  
Note that the **Make Current** button is not displayed if the administrator has forbidden to edit the current version in the settings of the [Document Versions](document-version.md#system-tab) widget.

- [Compare versions](#compare-versions). The option is available for **.doc** and **.docx** files.

On the **Deleted** tab, you can:

**(docs-versions-03.PNG)**

- Move a version to the list of outdated versions or drafts by clicking **Restore**. This will allow you to download it to your computer, compare it with other versions, etc.

- Delete a version permanently by clicking the trash can icon next to it.

- Permanently delete all versions on the tab by clicking **Delete All** at the bottom of the window



## View a document version

On the version view page, you can read its contents.

Please note that you cannot view a version from the **Deleted** tab. To view its contents, restore the version first.

The buttons on the bottom panel of the view form allow you to:

- [Edit](360009671252.md#view) the current or outdated version, as well as a draft.

- Make a outdated version or draft current.

- Compare any versions except deleted versions.

- Move a version to the list of deleted versions.

**(docs-version-1.png)**

You can also download a version of the document to your computer, print it, or copy the document preview link to your clipboard. To do this, use the icons in the upper right corner of the page.

Please note that only users with [view permissions](360007527512.md#assign) can open the document preview page via the link.

The sidebar displays the [associated activity stream](360014352191.md) of the version. Here you can chat, share files, mention users, react to messages, and add them to [Favorites](360014162972.md#favorites).



Please note that messages will only appear on the version you're viewing. They won't be added to the activity stream of the document.



## Compare versions

````
начало внимание

````
Version comparison is only available for **.doc **and **.docx** format files, it also requires an integration with a file viewing and editing service that allows document comparison. 

````
конец внимание

````
If a **Document** app item contains a **.doc **or **.docx** file, you can:

- Compare the current version with one of the older versions or with a newly uploaded file.

- Compare any two versions of the file.

The result will be shown in a new window.

### Compare the current version

On the sidebar of the [view page](360009671252.md#view), click **Compare** and select one of the options:

**(comparison_02.PNG)**

- **With File**. Upload a file of the same format and click **Compare**.

- **With Version**. Select a file version added before, and click **Compare**.

### Compare any two versions

On the sidebar of an [item view page](360009671252.md), click **All Versions**. On the **All**, **Current**, **Outdated**, or **Drafts** tab, click the **Compare** button below the document name and select the version number for comparison. You can only compare versions of the same format.

**(comparison_03.PNG)**

### Comparison results

The comparison result document is shown in a separate window. All changes are highlighted. For details, hover over the highlighted text.

If you have set up an integration with a file viewing and editing service that allows document comparison, you can edit the document with comparison results and then save it as a new version by clicking **Add Version**.

**(vers5.PNG)**

The new file will become the current version. It will be displayed in the list of versions on the item’s sidebar.

**Note**: In the [Document Versions](document-version.md#system-tab) widget settings, the system administrator can enable the **Read only > Yes** option. Then the **Add Version** button will be unavailable an users cannot add a new version of the document.