1--- 2section: cli-commands 3title: npm-unpublish 4description: Remove a package from the registry 5--- 6 7# npm-unpublish(1) 8 9## Remove a package from the registry 10 11### Synopsis 12 13#### Unpublishing a single version of a package 14 15```bash 16npm unpublish [<@scope>/]<pkg>@<version> 17``` 18 19#### Unpublishing an entire package 20 21```bash 22npm unpublish [<@scope>/]<pkg> --force 23``` 24 25### Warning 26 27Consider using the `deprecate` command instead, if your intent is to encourage users to upgrade, or if you no longer want to maintain a package. 28 29### Description 30 31This removes a package version from the registry, deleting its 32entry and removing the tarball. 33 34If no version is specified, or if all versions are removed then 35the root package entry is removed from the registry entirely. 36 37Even if a package version is unpublished, that specific name and 38version combination can never be reused. In order to publish the 39package 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. 40 41To 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>. 42 43 44### See Also 45 46* [npm deprecate](/cli-commands/npm-deprecate) 47* [npm publish](/cli-commands/npm-publish) 48* [npm registry](/using-npm/registry) 49* [npm adduser](/cli-commands/npm-adduser) 50* [npm owner](/cli-commands/npm-owner) 51