---
name: "npm-unpublish"
section: "1"
platform: "linux"
package: "npm"
version: "9.2.0~ds1-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/npm-unpublish"
---

# 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