yarn version

Updates the package version.

Using the yarn version command you can update the version of your package via the command line.

For example, starting with this package.json package.json:

{"name":"example-yarn-package","version":"1.0.1","description":"An example package to demonstrate Yarn"}

When we run the yarn version command:

yarn version

info Current version: 1.0.1 question New version: 1.0.2 info New version: 1.0.2 ✨ Done in 9.42s. 

We will get this updated package.json:

{"name":"example-yarn-package","version":"1.0.2","description":"An example package to demonstrate Yarn"}

Note: The new version you enter must be a valid SemVer version.

If you run yarn version within a Git repository a Git tag will be created by default following the format v0.0.0.

You can customize the git tag that is created or disable this behavior by using yarn config set.

To change the prefix of the git tag you can use version-tag-prefix:

yarn config set version-tag-prefix "v"

Or you can change the git message using version-git-message where %s is the version string:

yarn config set version-git-message "v%s"

You can also turn signing git tags on or off using version-sign-git-tag:

yarn config set version-sign-git-tag false

You can even enabled or disable the git tagging behavior entirely by using version-git-tag:

yarn config set version-git-tag true

If you would like to stop git commit hooks from running, you can disable them using version-commit-hooks:

yarn config set version-commit-hooks false

Create a new version using an interactive session to prompt you for a new version.

Creates a new version specified by <version>.

Creates a new version by incrementing the major, minor, or patch number of the current version.

Creates a new version without creating a git tag.

Bypasses running commit hooks when committing the new version.