How to fix npm ERR! code E403 npm ERR! 403 Forbidden - PUT https://registry.npmjs.org/package - You do not have permission to publish in npm | DevErrors

How to fix "npm ERR! code E403 npm ERR! 403 Forbidden - PUT https://registry.npmjs.org/package - You do not have permission to publish"

1Check if package name is available

Search for existing packages:

bash

# Search npm for the package name
npm search <package-name>

# Or check directly
npm view <package-name>

If it exists, you'll need a different name or use a scoped package.

2Use a scoped package name

Scoped packages include your username/org:

json

{
  "name": "@yourusername/package-name",
  "version": "1.0.0"
}

Publish with public access:

bash

npm publish --access public

3Verify your email

npm requires verified email to publish:

1. Go to npmjs.com
2. Log in to your account
3. Check for email verification banner
4. Click verification link in your email

Then retry:

bash

npm publish

4Verify you are logged in as correct user

Check your current login:

bash

# Check who you're logged in as
npm whoami

# If wrong user, log out and log in
npm logout
npm login

5Increment version number

You cannot republish the same version:

bash

# Increment version
npm version patch  # 1.0.0 -> 1.0.1
# or
npm version minor  # 1.0.0 -> 1.1.0

# Then publish
npm publish

6Remove private flag

Check package.json for private setting:

json

{
  "name": "my-package",
  "private": false  // Remove or set to false
}

The "private": true setting prevents publishing.

7Check organization permissions

For org-scoped packages (@org/package):

1. Go to npmjs.com/org/[your-org]
2. Check you're a member with publish permissions
3. Ask org admin to add you if needed

Verify with:

bash

npm team ls @org:developers

Advanced notes

For GitHub Packages publishing:

json

{
  "name": "@username/package",
  "publishConfig": {
    "registry": "https://npm.pkg.github.com"
  }
}

Requires a Personal Access Token with write:packages scope.

For CI/CD, the token must have publish permissions. In GitHub Actions, use:

yaml

permissions:
  packages: write

If publishing to both npm and GitHub Packages, configure separate registries for each scope in .npmrc.

How to fix npm ERR! code E403 npm ERR! 403 Forbidden - PUT https://registry.npmjs.org/package - You do not have permission to publish in npm

What this error means

Typical symptoms

Common causes

How to fix "npm ERR! code E403 npm ERR! 403 Forbidden - PUT https://registry.npmjs.org/package - You do not have permission to publish"

Advanced notes

Related errors

Official resources & further reading