PATH:
usr
/
local
/
lib
/
node_modules
/
npm
/
docs
/
content
/
cli-commands
--- section: cli-commands title: npm-deprecate description: Deprecate a version of a package --- # npm-deprecate(1) ## Deprecate a version of a package ### Synopsis ```bash npm deprecate <pkg>[@<version>] <message> ``` ### Description This command will update the npm registry entry for a package, providing a deprecation warning to all who attempt to install it. It works on [version ranges](https://semver.npmjs.com/) as well as specific versions, so you can do something like this: ```bash npm deprecate my-thing@"< 0.2.3" "critical bug fixed in v0.2.3" ``` Note that you must be the package owner to deprecate something. See the `owner` and `adduser` help topics. To un-deprecate a package, specify an empty string (`""`) for the `message` argument. Note that you must use double quotes with no space between them to format an empty string. ### See Also * [npm publish](/cli-commands/npm-publish) * [npm registry](/using-npm/registry)
[-] npm-build.md
[edit]
[-] npm-bundle.md
[edit]
[-] npm-prune.md
[edit]
[-] npm-repo.md
[edit]
[-] npm-owner.md
[edit]
[-] npm-edit.md
[edit]
[-] npm-audit.md
[edit]
[-] npm-unpublish.md
[edit]
[-] npm-bin.md
[edit]
[-] npm-test.md
[edit]
[-] npm-run-script.md
[edit]
[-] npm-completion.md
[edit]
[-] npm-adduser.md
[edit]
[+]
..
[-] npm-deprecate.md
[edit]
[-] npm-link.md
[edit]
[-] npm-root.md
[edit]
[-] npm-dist-tag.md
[edit]
[-] npm-update.md
[edit]
[-] npm-start.md
[edit]
[-] npm-config.md
[edit]
[-] npm-hook.md
[edit]
[-] npm-token.md
[edit]
[-] npm-pack.md
[edit]
[-] npm-stars.md
[edit]
[-] npm-publish.md
[edit]
[-] npm-whoami.md
[edit]
[-] npm-install-ci-test.md
[edit]
[-] npm-prefix.md
[edit]
[-] npm-shrinkwrap.md
[edit]
[-] npm.md
[edit]
[-] npm-install-test.md
[edit]
[-] npm-version.md
[edit]
[-] npm-team.md
[edit]
[-] npm-fund.md
[edit]
[-] npm-restart.md
[edit]
[-] npm-star.md
[edit]
[-] npm-ci.md
[edit]
[-] npm-ls.md
[edit]
[-] npm-explore.md
[edit]
[-] npm-view.md
[edit]
[-] npm-dedupe.md
[edit]
[-] npm-cache.md
[edit]
[-] npm-uninstall.md
[edit]
[-] npm-ping.md
[edit]
[-] npm-install.md
[edit]
[-] npm-access.md
[edit]
[-] npm-help-search.md
[edit]
[-] npm-help.md
[edit]
[-] npm-org.md
[edit]
[-] npm-init.md
[edit]
[-] npm-logout.md
[edit]
[-] npm-doctor.md
[edit]
[-] npm-stop.md
[edit]
[-] npm-bugs.md
[edit]
[-] npm-rebuild.md
[edit]
[-] npm-docs.md
[edit]
[-] npm-profile.md
[edit]
[-] npm-outdated.md
[edit]
[-] npm-search.md
[edit]