Distribution tags (dist-tags) supplement semantic versioning (e.g., v0.12). Use them to organize and label different versions of packages. In addition to being more human-readable than semver numbering, tags allow publishers to distribute their packages more effectively.
To add a tag to a specific version of your package, use:
npm dist-tag add <pkg>@<version> [<tag>]
npm publish will tag your package with the
latest tag. If you
--tag flag, you can specify another tag to use. For example, the
following will publish your package with the
npm publish --tag beta
npm install <pkg> will use the
latest tag by default.
To override this behavior, use
npm install <pkg>@<tag>. The following example will install the
somepkg at the version that has been tagged with
npm install somepkg@beta
Because dist-tags share the same namespace as semver, avoid using tag names that may cause a conflict. The best practice is to avoid using tags beginning with a number or the letter "v".
Last modified February 13, 2023 Found a typo? Send a pull request!