You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
### Summary: Added notes on deprecated legacy access token references
and removed few documentation due to deprecation
### File Changes (3 files)
1.
`content/integrations/integrating-npm-with-external-services/creating-and-viewing-access-tokens.mdx`
2.
`content/integrations/integrating-npm-with-external-services/about-access-tokens.mdx`
3.
`content/integrations/integrating-npm-with-external-services/using-private-packages-in-a-ci-cd-workflow.mdx`
### Changes Made
- Added `note` for legacy token creation workflow from access tokens
documentation
---------
Co-authored-by: Di Hei <[email protected]>
Copy file name to clipboardExpand all lines: content/integrations/integrating-npm-with-external-services/about-access-tokens.mdx
+9-6Lines changed: 9 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,10 +13,7 @@ redirect_from:
13
13
14
14
An access token is an alternative to using your username and password for authenticating to npm when using the API or the npm command-line interface (CLI). An access token is a hexadecimal string that you can use to authenticate, and which gives you the right to install and/or publish your modules.
As of November 2025, access tokens can only be [Granular access tokens](#about-granular-access-tokens). Legacy access tokens are removed.
20
17
21
18
You can create access tokens to give other tools (such as continuous integration testing environments) access to your npm packages. For example, GitHub Actions provides the ability to store [secrets](https://docs.github.com/en/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets), such as access tokens, that you can then use to authenticate. When your workflow runs, it will be able to complete npm tasks as you, including installing private packages you can access.
22
19
@@ -25,13 +22,19 @@ You can work with tokens from the web or the CLI, whichever is easiest. What you
25
22
npm token commands let you:
26
23
27
24
- View tokens for easier tracking and management
28
-
- Create new legacy tokens
25
+
- Create new legacy tokens (deprecated)
29
26
- Limit access according to IP address ranges (CIDR)
30
27
- Delete/revoke tokens
31
28
32
29
For more information on creating and viewing access tokens on the web and CLI, see "[Creating and viewing access tokens][create-token]".
33
30
34
-
## About legacy tokens
31
+
## About legacy tokens (Deprecated)
32
+
33
+
<Notevariant="danger">
34
+
35
+
**Warning:** Legacy access tokens are removed as of November 2025.
36
+
37
+
</Note>
35
38
36
39
Legacy tokens are created with the same permissions as the user who created them. The npm CLI automatically generates and uses a publish token when you run `npm login`.
Copy file name to clipboardExpand all lines: content/integrations/integrating-npm-with-external-services/creating-and-viewing-access-tokens.mdx
+2-60Lines changed: 2 additions & 60 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,37 +8,6 @@ You can [create](#creating-access-tokens) and [view](#viewing-access-tokens) acc
8
8
9
9
## Creating access tokens
10
10
11
-
### Creating legacy tokens on the website
12
-
13
-
<Note>
14
-
15
-
**Note:** For greater security, we recommend using [granular access tokens](#creating-granular-access-tokens-on-the-website) instead of legacy read-only tokens or legacy automation tokens. For CI/CD workflows, consider using [trusted publishing](/trusted-publishers), which eliminates the need for long-lived tokens entirely.
16
-
17
-
</Note>
18
-
19
-
1. In the upper right corner of the page, click your profile picture, then click **Access Tokens**.
20
-
21
-
<Screenshotsrc="/integrations/integrating-npm-with-external-services/tokens-profile.png"alt="Screenshot of the account menu with the tokens link selected" />
22
-
23
-
2. Click **Generate New Token**, then select **legacy token** from the dropdown menu.
24
-
25
-
<Screenshotsrc="/integrations/integrating-npm-with-external-services/create-token.png"alt="Screenshot of the create new token button" />
26
-
27
-
3. (Optional) Name your token.
28
-
29
-
4. Select the type of access token:
30
-
-**Read-only**: A read-only token can only be used to download packages from the registry. It will have permission to read any private package that you have access to. This is recommended for automation and workflows where you are installing packages, but not publishing new ones.
31
-
32
-
-**Automation**: An automation token can download packages and publish new ones, but if you have two-factor authentication (2FA) configured on your account, it will **not** be enforced. You can use an automation token in continuous integration workflows and other automation systems to publish a package even when you cannot enter a one-time passcode. For enhanced security in CI/CD workflows, consider using [trusted publishing](/trusted-publishers) instead, which eliminates the need for long-lived tokens.
33
-
34
-
-**Publish**: A publish token can perform any action on your behalf, including downloading packages, publishing packages, and changing user settings or package settings. If you have two-factor authentication configured on your account, you will be required to enter a one-time passcode when using a publish token. This is recommended for interactive workflows such as a CLI.
35
-
36
-
<Screenshotsrc="/integrations/integrating-npm-with-external-services/token-level-select.png"alt="Screenshot of the access level selection" />
37
-
38
-
5. Click **Generate Token**.
39
-
40
-
6. Copy the token from the top of page.
41
-
42
11
### Creating granular access tokens on the website
43
12
44
13
1. In the upper right corner of the page, click your profile picture, then click **Access Tokens**.
@@ -83,38 +52,12 @@ You can [create](#creating-access-tokens) and [view](#viewing-access-tokens) acc
83
52
84
53
### Creating tokens with the CLI
85
54
86
-
You can create tokens with **read-only** permissions or **read and publish** permissions with the CLI.
87
-
88
55
<Note>
89
56
90
-
**Note:** You cannot create legacy automation tokens or granular access tokens from the CLI. You must use the website to generate these types of tokens. For more information, see "[Creating legacy tokens on the website](#creating-legacy-tokens-on-the-website)" and "[Creating granular access tokens on the website](#creating-granular-access-tokens-on-the-website)."
57
+
**Note:** You cannot create granular access tokens from the CLI. You must use the website to generate these types of tokens. For more information, see "[Creating granular access tokens on the website](#creating-granular-access-tokens-on-the-website)."
91
58
92
59
</Note>
93
60
94
-
-**Read-only:** Tokens that allow installation and distribution only, but no publishing or other rights associated with your account.
95
-
-**Publish:** The default setting for new tokens, and most permissive token type. Publish tokens allow installation, distribution, modification, publishing, and all rights that you have on your account.
96
-
97
-
In addition, you can specify that the token is only valid for a specific IPv4 address range, using [CIDR][cidr-wiki] notation. The token will only be valid when used from the specified IP addresses.
98
-
99
-
1. To create a new token, on the command line, run:
100
-
-`npm token create` for a read and publish token
101
-
-`npm token create --read-only` for a read-only token
102
-
-`npm token create --cidr=[list]` for a CIDR-restricted read and publish token. For example, `npm token create --cidr=192.0.2.0/24`
103
-
-`npm token create --read-only --cidr=[list]` for a CIDR-restricted read-only token
104
-
2. When prompted, enter your password.
105
-
3. If you have enabled [two-factor authentication][tfa], when prompted, enter a one-time password.
106
-
4. Copy the token from the **token** field in the command output.
107
-
108
-
#### CIDR-restricted token errors
109
-
110
-
If the CIDR string you enter is invalid or in an inappropriate format, you will get an error similar to the one below:
Copy file name to clipboardExpand all lines: content/integrations/integrating-npm-with-external-services/using-private-packages-in-a-ci-cd-workflow.mdx
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,6 +27,12 @@ When generating an access token for use in a continuous integration environment,
27
27
28
28
If you use a legacy token instead, by default, `npm token create` will generate a token with both read and write permissions. We recommend creating a read-only token:
29
29
30
+
<Notevariant="danger">
31
+
32
+
**Warning:** Legacy access tokens are removed as of November 2025.
0 commit comments