NPM-UNPUBLISH(1) General Commands Manual NPM-UNPUBLISH(1)
NAME
npm-unpublish
Synopsis
<!-- AUTOGENERATED USAGE DESCRIPTIONS -->
To learn more about how the npm registry treats unpublish, see our <a
href="https://docs.npmjs.com/policies/unpublish" target="_blank"
rel="noopener noreferrer"> unpublish policies</a>
Warning
Consider using the deprecate command instead,
if your intent is to encourage users to upgrade, or if you no longer
want to maintain a package.
Description
This removes a package version from the registry, deleting its entry and
removing the tarball.
The npm registry will return an error if you are not logged
in.
If you do not specify a version or if you remove all of a package's
versions then the registry will remove the root package entry entirely.
Even if you unpublish a package version, that specific name and version
combination can never be reused. In order to publish the package again,
you must use a new version number. If you unpublish the entire package,
you may not publish any new versions of that package until 24 hours have
passed.
Configuration
<!-- AUTOGENERATED CONFIG DESCRIPTIONS -->
See Also
• package spec
• npm deprecate
• npm publish
• npm registry
• npm adduser
• npm owner
• npm login
9.2.0 May 2024 NPM-UNPUBLISH(1)
Generated by dwww version 1.16 on Tue Dec 16 04:54:47 CET 2025.