Skip to main content
The Increment Version Number action updates the version number in your app.json files and optionally updates dependency version numbers.

​
Usage

- uses: microsoft/AL-Go/Actions/IncrementVersionNumber@main
  with:
    versionNumber: '+0.1'

​
Inputs

​
versionNumber
string
required
The version to update to. Supports multiple formats:
  • Major.Minor[.Build] - Set absolute version (e.g., 2.0.0)
  • +1 - Bump to the next major version
  • +0.1 - Bump to the next minor version
  • +0.0.1 - Bump to the next build/patch version
​
projects
string
default:"*"
List of project names if the repository is setup for multiple projects. Use * for all projects.
​
skipUpdatingDependencies
boolean
default:"false"
Whether to skip updating dependency version numbers in all apps.
​
updateBranch
string
default:"${{ github.ref_name }}"
Set the branch to update. Defaults to the current branch.
​
directCommit
boolean
default:"false"
Whether to commit directly to the branch without creating a pull request.
​
shell
string
default:"powershell"
Shell in which you want to run the action. Options: powershell or pwsh.
​
actor
string
default:"${{ github.actor }}"
The GitHub actor running the action.
​
token
string
default:"${{ github.token }}"
The GitHub token running the action.

​
Examples

​
Increment minor version

name: Increment Version
on:
  workflow_dispatch:

jobs:
  increment:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      
      - uses: microsoft/AL-Go/Actions/IncrementVersionNumber@main
        with:
          versionNumber: '+0.1'

​
Set absolute version for all projects

- uses: microsoft/AL-Go/Actions/IncrementVersionNumber@main
  with:
    versionNumber: '2.0.0'
    projects: '*'
    skipUpdatingDependencies: false

​
Increment build version without updating dependencies

- uses: microsoft/AL-Go/Actions/IncrementVersionNumber@main
  with:
    versionNumber: '+0.0.1'
    skipUpdatingDependencies: true
    directCommit: true
By default, the action updates both the app versions and their dependency references to maintain consistency across your repository.
When using directCommit: true, changes are committed directly without review. Use with caution on protected branches.

Build docs developers (and LLMs) love

Get started for freeTalk to us