●Change8

Migrating to pnpm v11.18.0

Version v11.18.0 introduces 1 breaking change. This guide details how to update your code.

Released: 7/29/2026

1
Breaking Changes
2
Migration Steps
24
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

`pnpm setup``pnpm add --global``publishConfig.name``pnpm publish -r``pnpm change status``pnpm version -r``pnpm self-update``.npmrc``pnpm-workspace.yaml``.pnpmfile.(c|m)js``minimumReleaseAge``trustPolicy``ci``pnpm licenses list``pnpm dedupe --check``pnpm update --interactive``pnpm outdated``--include-github-actions``update.githubActions``resolvePeersFromWorkspaceRoot``overrides``link:``file:``workspace:`

Breaking Changes

●Issue #1

The `pnpm self-update` command no longer respects project-specific configurations like `.npmrc`, `pnpm-workspace.yaml`, or project `.pnpmfile.(c|m)js` for fetching pnpm versions. This means projects cannot redirect downloads, attach credentials, or load project-specific pnpmfiles during self-updates. Pnpmfiles from trusted sources (global config, command-line flags, etc.) still apply. To fix this, ensure your trusted registry and authentication are configured globally or via environment variables if you need to override defaults during self-updates.

Migration Steps

  1. 1
    If you were relying on project-specific `.npmrc`, `pnpm-workspace.yaml`, or project `.pnpmfile.(c|m)js` to control `pnpm self-update` behavior (e.g., redirecting downloads, attaching credentials, or loading project pnpmfiles), you will need to configure these settings globally or via environment variables.
  2. 2
    To include GitHub Actions dependencies in `pnpm outdated` or `pnpm update` checks, you must now explicitly pass the `--include-github-actions` flag or set `update.githubActions` to `true` in `pnpm-workspace.yaml`.

Release Summary

This release introduces support for publishing packages under different names and enhances `pnpm setup` for GitHub Actions. It also includes numerous bug fixes and performance improvements, particularly around dependency resolution, overrides, and interactive updates.

Need More Details?

View the full release notes and all changes for pnpm v11.18.0.

View Full Changelog