--- title: "Configuring Version Control" slug: "configuring-version-control" updated: 2026-03-30T10:41:06Z published: 2026-03-30T10:41:06Z canonical: "documentation.encodify.com/configuring-version-control" --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.encodify.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring Version Control ## What is Version Control --- **Location:** *Site Configuration > Module > Settings* Version Control is a convenient feature that saves previous versions of files uploaded to the module and enables the user to view the document history for a particular item. When the user uploads a new version of a document, the system saves a copy of the old document. A document history entry consists of the file name and version, the name of the user who uploaded the file and the date and time when it was uploaded. The user can view the document history, delete or download old versions and make any old version of the document current. **Classic UI** In the module, the history of files uploaded to a Media File Holder is displayed in a menu element specifically created and configured to display the Version Control information. **New UI** Note: Menu Elements are decommissioned for New UI in version 15 and replaced by[Item Views](/v1/docs/item-views) The version control menu will be available on the item once Version Control is enabled in module settings. Configuration of the menu element with version control in not required. In case Version Log functionality is required, the menu element with version control needs to be configured. When enabling version control for the module, it is possible to select between the 2 options: *Specific version numbering* and *Promotions*. ![Screenshot_2019-11-08_at_15.45.34.png](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/screenshot_2019-11-08_at_15.png) Selecting *Specific Version numbering* will allow you to manually define the numbering: whole numbers, fractional numbers or fractional numbers starting from one. Selecting *Promotions* will enable the Promotions functionality that allows you to configure visibility of the file versions based on the user's access to internal (fractional) or public (whole number) versions. Before enabling and configuring Promotions for your module, please make sure that you are familiar with the following list of restrictions and limitations: - Restricted version’s file name is visible on the classic UI - Restricted version file name will not be displayed anywhere in new UI, except previously listed places - Restricted version will trigger validation for the required file field - item cannot be saved - Restricted version file name will be present in Field object log - Preview of the files will be available for restricted versions - File name is hidden in other places for the restricted version - File name will be available in the send item - User can download the restricted version via Download merged PDF - User can download the restricted version by submitting the Ordering UI action - User can download the restricted version by copying the item with file on workflow - User can delete the restricted version in the status change window in the files section - [File disappears when user without access to current version triggers Increment Version action](https://encodeas.atlassian.net/browse/EBMS-24913) ## Configure Version Control with Specific Version Numbering --- Next steps should be followed in order to activate Version Control: 1. Go to the *Settings* section of the module configuration menu and click *Edit Settings* on the toolbar. 2. In the dialogue box that opens, select the *Enable Version Control* checkbox. 3. In the *Increment Strategy* field, select *Specific version numbering*. 4. Select the version numbering format: *Whole Numbers*, *Fractional Numbers*, or *Fractional Numbers (start from one).* ![Screenshot_2019-11-08_at_15.57.27.png](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/screenshot_2019-11-08_at_15(1).png) ## Configure Version Control for Promotions --- Next steps should be followed in order to activate Version Control: ![Screenshot_2019-11-08_at_15.58.22.png](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/screenshot_2019-11-08_at_15(2).png) 1. Go to the *Settings* section of the module configuration menu and click *Edit Settings* on the toolbar. 2. In the dialogue box that opens, select the *Enable Version Control* checkbox. 3. Select *Promotions* in the *Increment Strategy* selectbox. Please, note that after selecting promotions, manual selection of the version numbering will not be available. 4. Save the settings. ## Promotions: Configure access to versions --- Once *Promotions* has been enabled in module settings, 2 additional configuration options will appear in the Media Holder > Enable Version Control section. Select the corresponding access rights to configure users' access to the whole number (public) and fractional (internal) versions and save the settings. ![Screenshot_2019-11-08_at_16.08.29.png](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/screenshot_2019-11-08_at_16.png) ## Promotions: Configure Actions --- Execute task > Increment Version action type is available for the *Create, Update*, and *Workflow* events. Configuration parameters: **fieldId** - File field ID for which Promotions functionality is enabled. **makePublic** (true/false) - defines if the action will change the current version of the file to public (whole number) or internal (fractional) version. **copy** (true/false) - defines if a copy of the current version should be created on version transition. ![Screenshot_2019-11-08_at_16.30.40.png](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/screenshot_2019-11-08_at_16(1).png) Transfer of files from public versions to internal and vice versa is also available from the *Change current version* dialogue in classic UI. Please note that the latter is only available for site administrators. ![Screenshot_2019-11-08_at_16.32.05.png](https://cdn.document360.io/3a63e0a8-1221-4570-aaa1-d43f9b95a612/Images/Documentation/screenshot_2019-11-08_at_16(2).png) ## ##