# Toolchain Version Control

The toolchain Contains a group of tools and the sequence of execution for each tool. version control provides features to help track and manage changes. You can use version control to track changes during the development phase of a project In OneVision, a project is a collection of images and vision tools that performs different tasks, such as inspection, measurement, or identification. or to control deployments to a production environment.

The version system is a simple timeline view with the current working version at the head of the version history. It does not support branching or other complex version features.

Supported version control features include:

- Apply a version to the current state of a toolchain

- Restore a previous version of a toolchain

- Create a new project from a specific toolchain version of a toolchain

- Delete a version

Version control limitations:

- A toolchain must contain at least one tool before you can save a version

- A toolchain is limited to a maximum of 20 versions. You must delete older versions before saving any new versions.

- Version numbers are auto-generated and cannot be changed.

- A version only saves the state of the toolchain artifacts and does not maintain a version snapshot of the image database The set of images used to train and test your vision application..

How to view the toolchain version list

To view the toolchainContains a group of tools and the sequence of execution for each tool. version list:

1. Click Open Version History to list all the versions in toolchain view.

Inactive versions are only available in read-only mode, which means you cannot train them. You can navigate this read-only toolchain like a user who only has ViewerThe Viewer is a project-level role who can only view the project and export the runtime toolchain. The Viewer cannot edit the project in any way. role access to a projectIn OneVision, a project is a collection of images and vision tools that performs different tasks, such as inspection, measurement, or identification.. You can open each tool and view parameter settings, labels, metrics and statistics, and other details.

Note: Version snapshots of the image databaseThe set of images used to train and test your vision application. are not created with each toolchain version. Adding or deleting images after saving the toolchain version might result in some misalignment.

Click the three-dot menu to see what you can do with the versions:

- Open the project in new tab

- Edit comments

- Restore version

- Create new project from version

- Delete version

Click Refresh to refresh the version history.

How to save a toolchain version
Note: A toolchainContains a group of tools and the sequence of execution for each tool. must contain at least one tool before you can save a version

To save a version:

1. Click Save Version.

2. Optionally, add comments to your new version:

3. Click Save Version. Saving automatically creates a new working version.

The system stores:

- The version number

- The state of the toolchain

- The state of the tools

- The state of the labels and roles

- User who initiated the action to generate a new version

- Date and time

- Description as entered by the user creating the version

How to restore an earlier toolchain version

To restore to an earlier toolchainContains a group of tools and the sequence of execution for each tool. version:

1. On the Home page, open your projectIn OneVision, a project is a collection of images and vision tools that performs different tasks, such as inspection, measurement, or identification..

2. Click Open Version History.

3. Click the three-dot menu next to an earlier version and choose Restore this Version.

Restoring an older version results in the following:

- The current working state is saved as a new version.

  Note: The version comment indicates this as an auto-saved version by a restore action.

- A copy is made of the version selected for reversion. This copy is now the working version.

How to delete a toolchain version

To delete a version:

1. On the Home page, open your projectIn OneVision, a project is a collection of images and vision tools that performs different tasks, such as inspection, measurement, or identification..

2. Click Open Version History.

3. Click the three-dot menu next to an earlier version and choose Delete this Version.

4. Confirm your choice and click Yes, Delete Version [version number].