2021-01-07 16:12:19 -05:00
.TH "NPM\-UNPUBLISH" "1" "January 2021" "" ""
2011-11-26 09:21:03 -08:00
.SH "NAME"
2019-11-18 21:01:39 +02:00
\fB npm-unpublish\fR \- Remove a package from the registry
2019-11-05 14:55:08 -05:00
.SS Synopsis
2020-03-19 12:53:27 -04:00
.SS Unpublishing a single version of a package
2014-09-24 14:41:07 -07:00
.P
.RS 2
2014-11-04 15:08:12 -08:00
.nf
2020-03-19 12:53:27 -04:00
npm unpublish [<@scope>/]<pkg>@<version>
2014-11-04 15:08:12 -08:00
.fi
2014-09-24 14:41:07 -07:00
.RE
2020-03-19 12:53:27 -04:00
.SS Unpublishing an entire package
2011-11-26 09:21:03 -08:00
.P
2020-03-19 12:53:27 -04:00
.RS 2
.nf
npm unpublish [<@scope>/]<pkg> \- \- force
.fi
.RE
.SS Warning
2011-11-26 09:21:03 -08:00
.P
2020-03-19 12:53:27 -04:00
Consider using the \fB deprecate\fP command instead, if your intent is to encourage users to upgrade, or if you no longer want to maintain a package\.
2019-11-05 14:55:08 -05:00
.SS Description
2014-09-24 14:41:07 -07:00
.P
2011-11-26 09:21:03 -08:00
This removes a package version from the registry, deleting its
entry and removing the tarball\.
.P
If no version is specified, or if all versions are removed then
the root package entry is removed from the registry entirely\.
2014-03-19 09:25:40 -07:00
.P
Even if a package version is unpublished, that specific name and
2018-08-29 12:03:09 -07:00
version combination can never be reused\. In order to publish the
2020-03-19 12:53:27 -04:00
package again, a new version number must be used\. If you unpublish the entire package, you may not publish any new versions of that package until 24 hours have passed\.
2017-04-12 21:47:49 -07:00
.P
2020-11-03 20:39:24 -05:00
To learn more about how unpublish is treated on the npm registry, see our <a href="https://www\. npmjs\. com/policies/unpublish" target="_blank" rel="noopener noreferrer"> unpublish policies</a>\| \.
2019-11-05 14:55:08 -05:00
.SS See Also
2014-09-24 14:41:07 -07:00
.RS 0
.IP \(bu 2
2019-11-18 21:01:39 +02:00
npm help deprecate
2014-09-24 14:41:07 -07:00
.IP \(bu 2
2019-11-18 21:01:39 +02:00
npm help publish
2014-09-24 14:41:07 -07:00
.IP \(bu 2
2019-11-05 14:55:08 -05:00
npm help registry
2014-09-24 14:41:07 -07:00
.IP \(bu 2
2019-11-18 21:01:39 +02:00
npm help adduser
2014-09-24 14:41:07 -07:00
.IP \(bu 2
2019-11-18 21:01:39 +02:00
npm help owner
2014-09-24 14:41:07 -07:00
.RE