Important: This documentation covers modern versions of Yarn.
For 1.x docs, see classic.yarnpkg.com.
Yarn
yarn addyarn binyarn cache cleanyarn config getyarn config setyarn config unsetyarn configyarn constraints queryyarn constraints sourceyarn constraintsyarn dedupeyarn dlxyarn execyarn explain peer-requirementsyarn explainyarn infoyarn inityarn installyarn linkyarn nodeyarn npm audityarn npm infoyarn npm loginyarn npm logoutyarn npm publishyarn npm tag addyarn npm tag listyarn npm tag removeyarn npm whoamiyarn packyarn patch-commityarn patchyarn plugin import from sourcesyarn plugin importyarn plugin listyarn plugin removeyarn plugin runtimeyarn rebuildyarn removeyarn runyarn searchyarn set resolutionyarn set version from sourcesyarn set versionyarn stageyarn unlinkyarn unplugyarn upyarn upgrade-interactiveyarn version applyyarn version checkyarn versionyarn whyyarn workspaceyarn workspaces focusyarn workspaces foreachyarn workspaces list

yarn version

Plugin

To use this command, first install the version plugin: yarn plugin import version

Apply a new version to the current package.

Usage

$> yarn version <strategy>

Examples

Immediately bump the version to the next major :

yarn version major

Prepare the version to be bumped to the next major :

yarn version major --deferred

Options

Definition
Description

-d,--deferred

Prepare the version to be bumped during the next release cycle

-i,--immediate

Bump the version immediately

Details

This command will bump the version number for the given package, following the specified strategy:

  • If major, the first number from the semver range will be increased (X.0.0).

  • If minor, the second number from the semver range will be increased (0.X.0).

  • If patch, the third number from the semver range will be increased (0.0.X).

  • If prefixed by pre (premajor, ...), a -0 suffix will be set (0.0.0-0).

  • If prerelease, the suffix will be increased (0.0.0-X); the third number from the semver range will also be increased if there was no suffix in the previous version.

  • If decline, the nonce will be increased for yarn version check to pass without version bump.

  • If a valid semver range, it will be used as new version.

  • If unspecified, Yarn will ask you for guidance.

For more information about the --deferred flag, consult our documentation (https://yarnpkg.com/features/release-workflow#deferred-versioning).