Solving the `params` should be awaited error on NextJS 15

Find out how to resolve the "params should be awaited" error when upgrading to NextJS 15. This article explains why this error occurs and provides a step-by-step guide to correcting it.
•
Updated on August 14, 2026
•
2 min read
Believemy logo

You may have encountered this error message when upgrading to the latest version of NextJS 15:

CONSOLE
Error: Route "/xxx/[slug]" used `params.slug`. `params` should be awaited before using its properties.

If that's the case: this is due to the new features introduced in NextJS 15.

Fortunately, rest assured, it's very simple to overcome! 😉

 

Understanding the `params` should be awaited Error

This error arises because you very likely have one of your components that uses the URL parameters:

JSX
export default async function Page({ params: { slug } }) {
    // ...
}

In our example, we expect a slug parameter from the URL /xxx/[slug].

Although this worked with previous versions of NextJS, it is no longer the case now. 👀

 

Fixing the `params` should be awaited Error

To fix this error, it's very simple: you just need to await for params to be properly loaded by NextJS.

Good to know

Since NextJS 15, params is called in an asynchronous manner. It is a promise that needs to be awaited with the await keyword.

Here's how to fix this error:

JSX
export default async function Page({ params }) {
    const { slug } = await params;

    // ...
}

And that's it!

 

Going Further with NextJS 15

Want to get up to speed with NextJS 15? Check out our dedicated NextJS training! You can start it right now, and it will introduce you to all the new features of the latest version of NextJS!

Category: Developers

Share this article

Want to help us? Share this article on your networks or even better: on your site, in an article or in your newsletter.

Believemy logo
Comments (0)

You need to be logged in to comment on this article: log in or sign up.

Read next

What's new in NextJS 15

NextJS 15 was presented to the world on October 24, 2024 in San Francisco. Here's everything we know about NextJS 15's powerful new features!

December 5, 2024

Implementing over-request revalidation with NextJS

If you're a web developer, you probably know how important it is to have a fast, responsive site to deliver an optimal user experience. In this article, we're going to show you how to set up on-demand revalidation with NextJS, a feature that refreshes your site's data only when necessary. Using this method, you can save resources and improve the performance of your website, while offering up-to-date data to your users.

December 9, 2024

Setting up SCSS themes and contexts with NextJs or React

You can't modify a scss variable, because scss converts its code to css, applying the variable values directly. This makes it difficult to set up a light/dark theme on your React or Next project and scss. Fortunately, there are solutions, which we'll be exploring in this article.

December 11, 2024

What's new in Next.js 16

Next.js 16 was announced at the event on 22 October 2025 in San Francisco: here are all the new features of the most popular React framework of recent years!

October 22, 2025

Setting up a loader when changing a Nextjs page

Have you ever been on a site where you click on a link and nothing happens? Or perhaps you've wondered whether your request was actually received? This is where having a loader comes in. In this article, we'll explain why it's important to have a loader on your website, how to set it up in your Nextjs project and create a function that will display the loader until the page is loaded. If you want to improve the user experience on your website and reassure your visitors, this article is for you.

December 11, 2024

Understanding .env files with ReactJS

Find out how to really use the .env file with React or NextJS so you never make a mistake again.

December 9, 2024

React vs NextJS: what should you choose for your project in 2025?

Which technology should you use, React or NextJS? Discover their advantages and disadvantages to choose the one best suited to your projects.

December 9, 2024

How to use localStorage in a NextJs or React application

The aim of this article is to teach you how to use localStorage in a Next.JS or React application. Indeed, there are a few differences with the normal use, in a vanilla application.

December 11, 2024

Become the solopreneur you dream of being.

First project, career change, business launch: access our courses, practice on real-world cases, and move forward with clear guidance.