nextjs - ✅(Solved) Fix Docs: `npx next upgrade` does not work [1 pull requests, 2 comments, 3 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
vercel/next.js#90425Fetched 2026-04-08 00:20:11
View on GitHub
Comments
2
Participants
3
Timeline
11
Reactions
0
Assignees
Timeline (top)
commented ×2labeled ×2referenced ×2assigned ×1

Fix Action

Fixed

PR fix notes

PR #90435: docs: clarify that next upgrade is for 16.1.x+

Description (problem / solution / changelog)

Closes: https://github.com/vercel/next.js/issues/90425

Changed files

  • docs/01-app/01-getting-started/18-upgrading.mdx (modified, +1/-1)
  • docs/01-app/03-api-reference/06-cli/next.mdx (modified, +1/-0)

Code Example

npx next upgrade

---

user@fedora:~/github/project$ npx next upgrade
Invalid project directory provided, no such directory: /home/user/project/upgrade
RAW_BUFFERClick to expand / collapse

What is the documentation issue?

https://nextjs.org/docs/app/getting-started/upgrading says to run

npx next upgrade

But that results in

user@fedora:~/github/project$ npx next upgrade
Invalid project directory provided, no such directory: /home/user/project/upgrade

Is there any context that might help us understand?

This was run in a project with Next.js: v16.0.7 npx @next/codemod@canary upgrade latest worked.

Does the docs page already exist? Please link to it.

https://nextjs.org/docs/app/getting-started/upgrading

extent analysis

Quick Fix

Run the latest Next.js CLI explicitly (or use npm exec)

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING