Skip to content

Conversation

@jpg619
Copy link
Contributor

@jpg619 jpg619 commented Oct 27, 2025

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

@jpg619 jpg619 self-assigned this Oct 27, 2025
@jpg619 jpg619 marked this pull request as ready for review October 27, 2025 19:11
@jpg619 jpg619 requested review from a team and leobalter as code owners October 27, 2025 19:11
@wraithgar
Copy link
Member

Only the last two files changed in this PR are actually sourced from this repo. The rest are legacy docs for old versions of npm, sourced from https://github.com/npm/cli itself. We don't need to backport updates there, only the latest version of docs for registry-specific things are authoritative. We may want to consider adding warning headers when folks are browsing legacy docs to remind them, but that's outside the scope of this PR.

@wraithgar
Copy link
Member

Additionally, those proposed changes would be incorrect for those old version of npm. The defaults are baked into npm itself, not the registry. Those files are build directly from npm config itself. We intentionally made a tight coupling there so that docs would reflect reality. Changing those defaults would have to wait till npm 12.

- **token:** The first digits of the actual token.
- **create:** Date the token was created.
- **readonly:** If yes, indicates a read-only token. If no, indicates a token with both read and publish permissions.
- **created:** Date the token was created.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image


- [Legacy tokens](#about-legacy-tokens)
- [Granular access tokens](#about-granular-access-tokens)
As of November 2025, access tokens can only be [Granular access tokens](#about-granular-access-tokens). Legacy access tokens are deprecated.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

For more information on creating and viewing access tokens on the web and CLI, see "[Creating and viewing access tokens][create-token]".

## About legacy tokens
## About legacy tokens (Deprecated)
Copy link
Contributor Author

@jpg619 jpg619 Oct 30, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

jpg619 and others added 2 commits October 30, 2025 16:41
Co-authored-by: Di Hei <dhei@github.com>
Added a warning about the deprecation of legacy access tokens.

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:

<Note variant="danger">
Copy link
Contributor Author

@jpg619 jpg619 Oct 30, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

jpg619 and others added 3 commits October 30, 2025 17:15
…out-access-tokens.mdx

Co-authored-by: Di Hei <dhei@github.com>
…ing-private-packages-in-a-ci-cd-workflow.mdx

Co-authored-by: Di Hei <dhei@github.com>
…out-access-tokens.mdx

Co-authored-by: Di Hei <dhei@github.com>

- [Legacy tokens](#about-legacy-tokens)
- [Granular access tokens](#about-granular-access-tokens)
As of November 2025, access tokens can only be [Granular access tokens](#about-granular-access-tokens). Legacy access tokens are removed.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

@jpg619 jpg619 changed the base branch from main to release-110525 October 31, 2025 16:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants