# Nextjs-auth0 V3 lockfile peer dependencies list Next.js 15 but docs state no Next.js 15 support

**URL:** <https://community.auth0.com/t/nextjs-auth0-v3-lockfile-peer-dependencies-list-next-js-15-but-docs-state-no-next-js-15-support/199517>\
**Category:** Get Help\
**Tags:** sdks-quickstarts, nextjs-auth0\
**Created:** [May 1, 2026, 3:04pm UTC](https://community.auth0.com/t/nextjs-auth0-v3-lockfile-peer-dependencies-list-next-js-15-but-docs-state-no-next-js-15-support/199517 "2026-05-01T15:04:33Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![joseph.d.lim](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/joseph.d.lim/32/59823_2.png) [@joseph.d.lim](https://community.auth0.com/u/joseph.d.lim)\
**Post date:** [May 1, 2026, 3:04pm UTC](https://community.auth0.com/t/nextjs-auth0-v3-lockfile-peer-dependencies-list-next-js-15-but-docs-state-no-next-js-15-support/199517/1 "2026-05-01T15:04:33Z")

</div>

I am looking for clarification on the v3 nextjs-auth0 package with Next.js 15. It lists v15 in the lockfile but the README specifically states that 15 support requires v4 of the package. Can someone please help me understand what is correct? The auth0 package currently blocks upgrades for us.

Thanks!

---

<div class="post-metadata">

**Author:** ![nik.baleca](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/nik.baleca/32/68749_2.png) [@nik.baleca](https://community.auth0.com/u/nik.baleca)\
**Post date:** [May 1, 2026, 4:02pm UTC](https://community.auth0.com/t/nextjs-auth0-v3-lockfile-peer-dependencies-list-next-js-15-but-docs-state-no-next-js-15-support/199517/3 "2026-05-01T16:02:12Z")

</div>

Hi @joseph.d.lim

Welcome to the Auth0 Community!

Allow me some time to investigate this discrepancy you mentioned and I will come back with further clarification on the matter!

Kind Regards,  
Nik

---

<div class="post-metadata">

**Author:** ![nik.baleca](https://sea1.discourse-cdn.com/auth0/user_avatar/community.auth0.com/nik.baleca/32/68749_2.png) [@nik.baleca](https://community.auth0.com/u/nik.baleca)\
**Post date:** [May 4, 2026, 9:17pm UTC](https://community.auth0.com/t/nextjs-auth0-v3-lockfile-peer-dependencies-list-next-js-15-but-docs-state-no-next-js-15-support/199517/4 "2026-05-04T21:17:30Z")

</div>

Hi again!

**You must upgrade to `@auth0/nextjs-auth0` v4 to support Next.js 15.**

While your package manager might resolve Next.js 15 as a peer dependency in v3 without throwing an installation error, the v3 SDK will critically fail at runtime in a Next.js 15 environment.

Let’s look at exactly _why_ this strict version requirement exists and why the lockfile might be sending mixed signals:

In Next.js 15, Vercel introduced a massive architectural breaking change to dynamic APIs. Functions that read the incoming request state—specifically `cookies()` and `headers()` —were changed from **synchronous** functions to **asynchronous** functions.

The `@auth0/nextjs-auth0` v3 SDK was written for Next.js 13 and 14. Under the hood, it heavily relies on calling `cookies()` and `headers()` synchronously to manage the encrypted session state. If you try to run v3 on Next.js 15, the SDK will attempt to read a cookie synchronously, receive an unresolved Promise instead of a string, and your authentication flow will crash.

During the Next.js 15 Release Candidate (RC) phase, peer dependency ranges are sometimes broadened across the ecosystem (e.g., `^13.0.0 || ^14.0.0 || ^15.0.0` ) to allow for initial compatibility testing without `npm` throwing strict peer dependency errors. This is likely why you see v15 referenced in the lockfile tree. However, successful installation does not equal runtime compatibility.

If you have any other questions let me know!

Kind Regards,  
Nik

---

<div class="post-metadata">

**Author:** ![system](https://global.discourse-cdn.com/auth0/original/3X/b/5/b560f266932fcce5d57f09a6595bd50518cae3f3.jpeg) [@system](https://community.auth0.com/u/system)\
**Post date:** [May 18, 2026, 9:18pm UTC](https://community.auth0.com/t/nextjs-auth0-v3-lockfile-peer-dependencies-list-next-js-15-but-docs-state-no-next-js-15-support/199517/5 "2026-05-18T21:18:24Z")

</div>

This topic was automatically closed 14 days after the last reply. New replies are no longer allowed.
