For the configuration of the extension there are two main parameters you need to set:

The saved version variable: This parameters is the name of the variable you use to save the version number. This variable will be incremented on each build. This variable can also be used as for example the build number. The saved version number needs to be in the format: *.*.*

Azure DevOps Personal Access Token: A personal access token for an account that can update build of releases. When using the extension within a build or release pipeline you need to supply a personal access token with the appropriate amounts of rights:

For using it within a build: Build: Read & Execute

For using it within a release: Release: Read, write and execute

Adding a personal access token to your build or release pipeline is only secure when you use the Azure Keyvault. Somewhat less secure is using a secure variable

When you need to auto increment the minor or major version number you need to check the check box: “Automatically update minor number” or “Automatically update major number”. When checked the options to insert the maximum patch / minor version number will appear.

For example fill in 9 as the maximum patch number 1.0.9 will be incremented to 1.1.0.

When you configure the variable with the version number as your build number format this number will be incremented with nicely with each build or release.