Next.js SEO: A Practical Guide to Making Your Website Search-Engine Friendly

Ibrahim Khalil Tushar — Thu, 01 Oct 2026 16:21:19 +0000

If you are building websites with Next.js, you have probably heard the word SEO many times.

SEO means Search Engine Optimization.

In simple words, SEO helps search engines like Google understand your website and show the right pages to people when they search for something.

For example, imagine you build a website that sells headphones.

Someone searches on Google:

"Best wireless headphones under $50"

If your website has good SEO, Google can understand your page and potentially show it in the search results.

But simply using Next.js does not automatically give you good SEO.

You still need to think about things like:

Server-side rendering
Metadata
Dynamic titles
Robots.txt
Sitemap
Canonical URLs
Structured data
Semantic HTML
Performance

In this article, we will go through these concepts step by step using simple examples.

1. Why SEO Matters in Next.js

Before talking about Next.js features, let's understand one important thing.

Search engines need to read and understand your content.

Imagine you have two websites.

Website A

The server sends a page containing the actual content:

<h1>Best Wireless Headphones</h1>
<p>These headphones have 30 hours of battery life.</p>

Website B

The server initially sends almost nothing:

<div id="root"></div>

Then JavaScript runs in the browser and loads the content.

The second approach can still work, but it can make crawling and indexing more complicated.

This is one reason server-rendered content is useful for SEO.

2. Server Components and SEO

One of the nice things about the Next.js App Router is that components are Server Components by default.

For example:

export default function ProductsPage() {
  return (
    <main>
      <h1>Our Products</h1>

      <p>
        Explore our latest headphones and accessories.
      </p>
    </main>
  );
}

This component does not need:

"use client";

So Next.js can render the page on the server.

That means the initial HTML can already contain useful content.

When should you use Client Components?

Client Components are useful when you need browser-side interactivity.

For example:

"use client";

import { useState } from "react";

export default function ProductButton() {
  const [count, setCount] = useState(0);

  return (
    <button onClick={() => setCount(count + 1)}>
      Add to Cart ({count})
    </button>
  );
}

This needs client-side JavaScript because the button has interactive state.

But you don't need to turn the whole page into a Client Component just because one button is interactive.

A better approach is to keep the main page as a Server Component and move only the interactive part into a Client Component.

For example:

export default function ProductPage() {
  return (
    <main>
      <h1>Wireless Headphones</h1>

      <p>
        Enjoy up to 30 hours of battery life.
      </p>

      <AddToCartButton />
    </main>
  );
}

And:

"use client";

export default function AddToCartButton() {
  return (
    <button>
      Add to Cart
    </button>
  );
}

This is a simple but useful pattern.

Keep content on the server when possible. Use client-side JavaScript where you actually need it.

3. Metadata: The First SEO Feature You Should Learn

One of the easiest SEO improvements in Next.js is metadata.

Metadata tells search engines and browsers important information about a page.

For example:

What is the page title?
What is the page description?
What image should be used when sharing?
What is the canonical URL?

In Next.js App Router, you can define metadata using the metadata object.

Example:

import type { Metadata } from "next";

export const metadata: Metadata = {
  title: "Wireless Headphones",
  description:
    "Explore our collection of affordable wireless headphones.",
};

export default function ProductsPage() {
  return (
    <main>
      <h1>Wireless Headphones</h1>
    </main>
  );
}

That's it.

Next.js will use this information to generate the appropriate HTML metadata.

4. Why the Title Is Important

Think about Google search results.

You might see something like:

Wireless Headphones | AudioStore

Then below it:

Explore our collection of affordable wireless headphones with long battery life.

The first part comes from the page title.

So instead of:

title: "Page"

you should write something meaningful.

For example:

title: "Wireless Headphones | AudioStore"

A good title tells both users and search engines what the page is about.

5. Writing a Good Description

The description gives additional context about your page.

Example:

description:
  "Shop affordable wireless headphones with long battery life and fast delivery.",

Avoid something like:

description: "Welcome to our website."

It doesn't tell the search engine or user much.

A better description explains:

What is this page about?

For example:

description:
  "Compare wireless headphones, battery life, features, and prices before buying.",

6. Metadata in the Root Layout

You can also define default metadata in your root layout.

For example:

import type { Metadata } from "next";

export const metadata: Metadata = {
  title: {
    default: "AudioStore",
    template: "%s | AudioStore",
  },

  description:
    "Find affordable headphones and audio accessories.",
};

Now a page can simply have:

export const metadata: Metadata = {
  title: "Wireless Headphones",
};

And the final title can become:

Wireless Headphones | AudioStore

This is very useful for larger websites.

7. Dynamic Metadata

Now let's say you have an e-commerce website.

You have pages like:

/products/sony-wh1000xm5
/products/airpods-pro
/products/jbl-tune

You don't want every page to have the same title.

For example:

Wireless Headphones | AudioStore

for every product.

Instead, you want:

Sony WH-1000XM5 | AudioStore

and:

AirPods Pro | AudioStore

This is where generateMetadata() becomes useful.

Example:

import type { Metadata } from "next";

type Props = {
  params: Promise<{
    slug: string;
  }>;
};

export async function generateMetadata(
  { params }: Props
): Promise<Metadata> {

  const { slug } = await params;

  const product = await getProduct(slug);

  return {
    title: `${product.name} | AudioStore`,
    description: product.description,
  };
}

Then your page can use the same product data:

export default async function ProductPage({
  params,
}: Props) {

  const { slug } = await params;

  const product = await getProduct(slug);

  return (
    <main>
      <h1>{product.name}</h1>

      <p>{product.description}</p>

      <strong>${product.price}</strong>
    </main>
  );
}

Now every product page can have unique metadata.

8. Real-Life Example: A Blog

Imagine you build a blog called:

DevTushar

You have these posts:

/blog/what-is-react-server-component
/blog/nextjs-seo-guide
/blog/javascript-promises

Each page should have its own title and description.

For example:

Next.js SEO Guide | DevTushar

and:

JavaScript Promises Explained | DevTushar

You can generate these dynamically from your database.

This is much better than manually creating hundreds of metadata objects.

9. Robots.txt

Now let's talk about another important SEO file:

robots.txt

Robots.txt gives instructions to search engine crawlers.

For example, you might want Google to crawl:

/blog
/products
/about

But you might not want it to crawl:

/admin
/dashboard
/account

In Next.js, you can create:

app/robots.ts

Example:

import type { MetadataRoute } from "next";

export default function robots(): MetadataRoute.Robots {
  return {
    rules: {
      userAgent: "*",
      allow: "/",
      disallow: [
        "/admin/",
        "/dashboard/",
        "/account/",
      ],
    },

    sitemap: "https://example.com/sitemap.xml",
  };
}

Next.js can generate the robots file for you.

10. Why Should You Block Dashboard Pages?

Imagine your website has:

/dashboard

A logged-in user can see their private information there.

There is no reason for Google to index this page.

So you can tell crawlers:

Don't crawl /dashboard

But remember something important:

robots.txt is not a security system.

You should never depend on robots.txt to protect private information.

Authentication and authorization should handle security.

Robots.txt is mainly about crawler behavior.

11. Sitemap

Now imagine your website has 500 blog posts.

How does Google discover all of them?

A sitemap can help.

A sitemap contains URLs that you want search engines to discover.

In Next.js, you can create:

app/sitemap.ts

Example:

import type { MetadataRoute } from "next";

export default function sitemap(): MetadataRoute.Sitemap {
  return [
    {
      url: "https://example.com",
      lastModified: new Date(),
    },

    {
      url: "https://example.com/about",
      lastModified: new Date(),
    },

    {
      url: "https://example.com/blog",
      lastModified: new Date(),
    },
  ];
}

Next.js can generate:

/sitemap.xml

automatically.

12. Dynamic Sitemap

For a real blog, you probably don't want to manually add every post.

Imagine you have:

1000 posts

Instead, you can get the posts from your database.

Example:

export default async function sitemap() {
  const posts = await getAllPosts();

  return posts.map((post) => ({
    url: `https://example.com/blog/${post.slug}`,
    lastModified: post.updatedAt,
  }));
}

Now when you publish a new article, the sitemap can include it automatically.

This is especially useful for content-heavy websites.

13. Canonical URLs

Let's say the same product can be accessed through different URLs.

For example:

/products/headphones
/products/headphones?color=black
/products/headphones?sort=popular

These URLs might represent essentially the same product page.

Search engines can sometimes have difficulty deciding which URL should be considered the main version.

That's where a canonical URL comes in.

You can specify the preferred URL.

Example:

export const metadata: Metadata = {
  alternates: {
    canonical: "https://example.com/products/headphones",
  },
};

Now you're telling search engines:

This is the main URL for this page.

14. Why Canonical URLs Matter

Imagine someone links to:

example.com/product?id=123

Another person links to:

example.com/products/headphones

If both URLs show the same content, you don't necessarily want search engines treating them as completely separate pages.

A canonical URL helps communicate your preferred version.

It is basically saying:

"If there are multiple URLs for this content, this is the main one."

15. JSON-LD and Structured Data

Now we get into something really useful for modern websites.

JSON-LD is a format that helps search engines understand what your page represents.

For example, suppose you have a product page.

A human can easily understand:

Sony WH-1000XM5
Price: $299
Rating: 4.8

But structured data gives search engines information in a standardized format.

For example:

const jsonLd = {
  "@context": "https://schema.org",
  "@type": "Product",
  name: "Sony WH-1000XM5",
  description: "Wireless noise cancelling headphones",
  offers: {
    "@type": "Offer",
    price: "299",
    priceCurrency: "USD",
  },
};

Then you can add it to the page:

<script
  type="application/ld+json"
  dangerouslySetInnerHTML={{
    __html: JSON.stringify(jsonLd),
  }}
/>

16. What Can JSON-LD Describe?

Structured data can describe many different things.

Product

Product name
Price
Availability
Brand
Rating

Article

Headline
Author
Published date
Modified date
Image

Organization

Company name
Logo
Website
Social profiles

FAQ

Question
Answer

Recipe

Ingredients
Cooking time
Calories
Rating

The important thing is to use the schema that actually matches your content.

Don't add fake information just because you want a rich result.

17. Semantic HTML

SEO isn't only about metadata.

Your actual HTML structure also matters.

For example, don't build everything with:

<div>
  <div>
    <div>My Article</div>
  </div>
</div>

when semantic elements are available.

Instead:

<article>
  <header>
    <h1>My Article</h1>
  </header>

  <p>
    This is the article content.
  </p>
</article>

This gives the document a clearer structure.

18. Common Semantic HTML Elements

Some useful semantic elements are:

<header>
<nav>
<main>
<section>
<article>
<aside>
<footer>

For example, a blog page could look like:

<header>
  <nav>
    ...
  </nav>
</header>

<main>
  <article>
    <h1>Next.js SEO Guide</h1>

    <section>
      <h2>What is SEO?</h2>
      <p>...</p>
    </section>

    <section>
      <h2>Metadata</h2>
      <p>...</p>
    </section>
  </article>
</main>

<footer>
  ...
</footer>

This is cleaner than using random <div> elements everywhere.

19. Heading Structure

Headings are also important for organizing content.

Usually, a page should have a clear main heading:

<h1>Next.js SEO Guide</h1>

Then supporting sections:

<h2>Metadata</h2>

<h2>Sitemap</h2>

<h2>Canonical URLs</h2>

And subsections:

<h3>Dynamic Metadata</h3>
<h3>Static Metadata</h3>

Think of headings like the table of contents of your page.

20. Don't Use Headings Just for Styling

A common beginner mistake is using:

<h1>Small text</h1>

just because they want a certain font size.

HTML elements should represent meaning.

If you only need visual styling, use CSS.

For example:

<p className="text-4xl font-bold">
  Hello
</p>

instead of using an <h1> only to make the text large.

21. Image SEO

Images are also part of SEO.

Instead of:

<Image
  src="/headphones.jpg"
/>

use meaningful alternative text:

<Image
  src="/headphones.jpg"
  alt="Black wireless noise cancelling headphones"
/>

The alt text helps describe the image when it cannot be displayed and improves accessibility.

Don't stuff keywords into alt text.

Bad:

headphones best headphones cheap headphones wireless headphones

Better:

Black wireless noise cancelling headphones

Describe the image naturally.

22. URLs Should Be Easy to Understand

Compare:

/products/12345

with:

/products/sony-wh1000xm5

The second URL gives humans and search engines more context.

For blog posts, this is common:

/blog/nextjs-seo-guide

instead of:

/blog/post?id=78291

Clean URLs are easier to read and share.

23. Page Performance and SEO

SEO isn't only about keywords.

User experience matters too.

If your page takes forever to load, people may leave.

Next.js provides many tools for building fast applications.

For example:

Server Components
Image optimization
Code splitting
Streaming
Caching
Static rendering

You should always think:

"Does this page really need to send this JavaScript to the browser?"

If the answer is no, keep that part on the server.

24. Lighthouse

One of my favorite tools for checking a website is Google Lighthouse.

You can open Chrome DevTools and run a Lighthouse audit.

It checks areas such as:

Performance
Accessibility
Best Practices
SEO

For example, you might get:

Performance: 92
Accessibility: 96
Best Practices: 100
SEO: 100

These numbers are useful for finding problems.

But don't blindly chase a perfect score.

A real website is more complicated than a single number.

Use Lighthouse as a tool to find issues, not as the entire definition of good SEO.

25. A Practical Next.js SEO Setup

Let's imagine we're building a website called:

AudioStore

The website has:

/
 /products
 /products/[slug]
 /blog
 /blog/[slug]
 /about
 /dashboard
 /admin

A basic SEO setup could look like this.

Root metadata

export const metadata: Metadata = {
  title: {
    default: "AudioStore",
    template: "%s | AudioStore",
  },

  description:
    "Shop wireless headphones and audio accessories.",
};

Product metadata

export async function generateMetadata({ params }) {
  const product = await getProduct(params.slug);

  return {
    title: product.name,
    description: product.description,

    alternates: {
      canonical: `https://audiostore.com/products/${product.slug}`,
    },
  };
}

Robots

export default function robots() {
  return {
    rules: {
      userAgent: "*",
      allow: "/",
      disallow: [
        "/dashboard/",
        "/admin/",
      ],
    },

    sitemap: "https://audiostore.com/sitemap.xml",
  };
}

Sitemap

export default async function sitemap() {
  const products = await getProducts();

  return products.map((product) => ({
    url: `https://audiostore.com/products/${product.slug}`,
    lastModified: product.updatedAt,
  }));
}

Now we have a basic SEO foundation.

26. A Simple SEO Checklist for Every Next.js Page

Whenever I create a new page, I like to ask a few simple questions.

1. Does the page have useful content?

If the page contains almost nothing useful, SEO won't magically fix it.

2. Is the title descriptive?

Good:
Next.js SEO Guide | DevTushar

Instead of:

Page 1

3. Does it have a useful description?

Explain what users will find on the page.

4. Is the content server-rendered where possible?

Don't make everything a Client Component without a reason.

5. Is the URL clean?

/blog/nextjs-seo-guide

is easier to understand than a complicated URL.

6. Are headings structured properly?

Use:

H1
 ├── H2
 │    ├── H3
 │    └── H3
 └── H2

7. Are images optimized?

Use Next.js <Image> when appropriate and provide meaningful alt text.

8. Does the page need canonical metadata?

Especially when multiple URLs can represent the same content.

9. Does the website have a sitemap?

Make sure important pages can be discovered.

10. Did you test it?

Run Lighthouse and inspect the generated HTML.

27. Common SEO Mistakes in Next.js

Here are some mistakes I see developers make.

Making the entire application a Client Component

Using:

"use client";

at the top of a large page just because one small part needs interaction.

Instead, isolate the interactive part.

Using the same title everywhere

For example:

My Website
My Website
My Website
My Website

Every important page should have a meaningful title.

Ignoring dynamic routes

If you have:

/products/[slug]

don't give every product the same metadata.

Use generateMetadata().

Forgetting the sitemap

If you have lots of pages, a sitemap can make URL discovery easier.

Blocking everything in robots.txt

Don't accidentally do:

disallow: "/"

because that tells crawlers not to access the entire site.

Using robots.txt for security

Again:

robots.txt is not authentication.

Private pages should be protected by your application.

Adding fake structured data

Don't claim a product has:

5-star rating

if it doesn't.

Structured data should represent the actual page content.

28. SEO Is More Than Keywords

This is probably the biggest lesson.

When people hear SEO, they often think:

"I need to add more keywords."

But modern SEO is much bigger than that.

You need to think about:

Content
   ↓
HTML structure
   ↓
Metadata
   ↓
Crawlability
   ↓
Performance
   ↓
Accessibility
   ↓
Structured data
   ↓
User experience

All of these pieces work together.

29. Think Like a Search Engine

When building a page, ask yourself:

If I were a search engine seeing this page for the first time, would I understand what it is?

For example, if your page contains:

<h1>Wireless Headphones</h1>

<p>
  Compare wireless headphones with long battery life,
  noise cancellation, and comfortable designs.
</p>

That's pretty clear.

Then you add:

Good title
Good description
Clean URL
Semantic HTML
Structured data
Sitemap
Canonical URL

Now you've given search engines much more useful information.

30. Final Thoughts

Next.js already gives us many tools that make SEO easier.

But using Next.js doesn't automatically make a website SEO-friendly.

As developers, we still need to make good decisions.

The most important things to remember are:

Keep important content server-rendered when possible.
Don't use Client Components everywhere.
Write useful metadata.
Use generateMetadata() for dynamic pages.
Create a sitemap.
Configure robots.ts carefully.
Use canonical URLs when needed.
Add structured data when it genuinely describes your content.
Use semantic HTML.
Optimize images and performance.
Test your website with Lighthouse.
Most importantly, create useful content for real people.

SEO is not one magic trick.

It is a collection of small technical and content decisions that make your website easier to crawl, understand, index, and use.

And that's what makes SEO worth learning as a Next.js developer.

If you can build these habits into your normal Next.js workflow, SEO stops feeling like a separate complicated topic.

It simply becomes part of building a good website.

DEV Community: Ibrahim Khalil Tushar

Next.js SEO: A Practical Guide to Making Your Website Search-Engine Friendly

1. Why SEO Matters in Next.js

Website A

Website B

2. Server Components and SEO

When should you use Client Components?

3. Metadata: The First SEO Feature You Should Learn

4. Why the Title Is Important

5. Writing a Good Description

6. Metadata in the Root Layout

7. Dynamic Metadata

8. Real-Life Example: A Blog

9. Robots.txt

10. Why Should You Block Dashboard Pages?

11. Sitemap

12. Dynamic Sitemap

13. Canonical URLs

14. Why Canonical URLs Matter

15. JSON-LD and Structured Data

16. What Can JSON-LD Describe?

Product

Article

Organization

FAQ

Recipe

17. Semantic HTML

18. Common Semantic HTML Elements

19. Heading Structure

20. Don't Use Headings Just for Styling

21. Image SEO

22. URLs Should Be Easy to Understand

23. Page Performance and SEO

24. Lighthouse

25. A Practical Next.js SEO Setup

Root metadata

Product metadata

Robots

Sitemap

26. A Simple SEO Checklist for Every Next.js Page

1. Does the page have useful content?

2. Is the title descriptive?

3. Does it have a useful description?

4. Is the content server-rendered where possible?

5. Is the URL clean?

6. Are headings structured properly?

7. Are images optimized?

8. Does the page need canonical metadata?

9. Does the website have a sitemap?

10. Did you test it?

27. Common SEO Mistakes in Next.js

Making the entire application a Client Component

Using the same title everywhere

Ignoring dynamic routes

Forgetting the sitemap

Blocking everything in robots.txt

Using robots.txt for security

Adding fake structured data

28. SEO Is More Than Keywords

29. Think Like a Search Engine

30. Final Thoughts