Some checks failed
Test examples / Test Examples (20) (push) Has been cancelled
Test examples / Test Examples (22) (push) Has been cancelled
Lock Threads / action (push) Has been cancelled
Trigger Release / start (push) Has been cancelled
Stale issue handler / stale (push) Has been cancelled
Update Font Data / create-pull-request (push) Has been cancelled
build-and-deploy / deploy-target (push) Has been cancelled
build-and-deploy / build (push) Has been cancelled
build-and-deploy / stable - aarch64-unknown-linux-musl - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-unknown-linux-musl - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-unknown-linux-gnu - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-unknown-linux-gnu - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-pc-windows-msvc - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-pc-windows-msvc - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-apple-darwin - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-apple-darwin - node@16 (push) Has been cancelled
build-and-deploy / build-wasm (nodejs) (push) Has been cancelled
build-and-deploy / build-wasm (web) (push) Has been cancelled
build-and-deploy / Deploy preview tarball (push) Has been cancelled
build-and-deploy / Potentially publish release (push) Has been cancelled
build-and-deploy / publish-turbopack-npm-packages (push) Has been cancelled
build-and-deploy / Deploy examples (push) Has been cancelled
build-and-deploy / thank you, build (push) Has been cancelled
build-and-deploy / Upload Turbopack Bytesize metrics to Datadog (push) Has been cancelled
Rspack Next.js development integration tests / Rspack integration tests (push) Has been cancelled
Rspack Next.js production integration tests / Rspack integration tests (push) Has been cancelled
Turbopack Next.js development integration tests / Next.js integration tests (push) Has been cancelled
Turbopack Next.js production integration tests / Next.js integration tests (push) Has been cancelled
Update Rspack test manifest / Update and upload Rspack development test manifest (push) Has been cancelled
Update Rspack test manifest / Update and upload Rspack production test manifest (push) Has been cancelled
Upload bundler test manifests to areweturboyet.com / Upload test results (push) Has been cancelled
Update React / create-pull-request (push) Has been cancelled
test-e2e-project-reset-cron / reset-test-project (push) Has been cancelled
Notify about the top 15 issues/PRs/feature requests (most reacted) in the last 90 days / run (push) Has been cancelled
74 lines
3.1 KiB
Plaintext
74 lines
3.1 KiB
Plaintext
---
|
|
title: A newer version is available
|
|
---
|
|
|
|
## What this notice means
|
|
|
|
The development overlay shows that your installed version of Next.js is not the latest available. During development, Next.js checks the [npm registry](https://www.npmjs.com/package/next) and compares your installed version against the latest release. If a newer version is available, Next.js displays a notice in the overlay.
|
|
|
|
Newer versions contain bug fixes and improved error tracing capabilities. Upgrade before investigating further.
|
|
|
|
Upgrading Next.js won't fix errors that originate in your own code or third-party libraries. However, newer versions often provide better error messages and stack traces that can help you identify the root cause.
|
|
|
|
If upgrading does not resolve your issue, search [GitHub Discussions](https://github.com/vercel/next.js/discussions) to see if others have encountered the same problem. If you cannot find a match, consider creating a new discussion with details about your error.
|
|
|
|
If you believe the issue is a bug in Next.js and you have a minimal, shareable reproduction repository, [open an issue on GitHub](https://github.com/vercel/next.js/issues/new/choose).
|
|
|
|
> **Good to know:** A reproduction repository is required when opening an issue. Issues without one are automatically closed.
|
|
|
|
## Staleness levels
|
|
|
|
- **Stale (patch or minor):** A newer stable release is available with bug fixes or new features.
|
|
- **Stale (prerelease):** You are on a canary release and a newer canary is available. Canary versions are published frequently, so this is expected.
|
|
- **Outdated (major):** Your installed version is behind by a major version. Upgrading is recommended to get security fixes and new features.
|
|
|
|
## Upgrading
|
|
|
|
Latest stable version:
|
|
|
|

|
|
|
|
To upgrade to the latest stable release:
|
|
|
|
```bash package="npm"
|
|
npm i next@latest
|
|
```
|
|
|
|
```bash package="yarn"
|
|
yarn add next@latest
|
|
```
|
|
|
|
```bash package="pnpm"
|
|
pnpm add next@latest
|
|
```
|
|
|
|
```bash package="bun"
|
|
bun add next@latest
|
|
```
|
|
|
|
To upgrade to the latest canary release:
|
|
|
|
```bash package="npm"
|
|
npm i next@canary
|
|
```
|
|
|
|
```bash package="yarn"
|
|
yarn add next@canary
|
|
```
|
|
|
|
```bash package="pnpm"
|
|
pnpm add next@canary
|
|
```
|
|
|
|
```bash package="bun"
|
|
bun add next@canary
|
|
```
|
|
|
|
If you are coming from an older major version, check out the [upgrade guides](/docs/app/guides/upgrading).
|
|
|
|
## Contributing
|
|
|
|
Next.js is open source and welcomes contributions. If you have identified a bug and want to fix it yourself, see the [contributing guide](https://github.com/vercel/next.js/blob/canary/contributing.md) or watch [How to Contribute to Open Source (Next.js)](https://www.youtube.com/watch?v=cuoNzXFLitc) to get started.
|
|
|
|
You can also help by [triaging issues](https://github.com/vercel/next.js/blob/canary/contributing/repository/triaging.md), [verifying canary releases](https://github.com/vercel/next.js/blob/canary/.github/comments/verify-canary.md), or providing a [minimal reproduction](https://github.com/vercel/next.js/blob/canary/.github/comments/invalid-reproduction.md) for existing issues.
|