GenerateMetadata for dynamic metadata in NextJS - Performance & Optimization

Performance: GenerateMetadata for dynamic metadata

MEDIUM IMPACT

This affects the page load speed by controlling when and how metadata is generated and sent to the browser, impacting the Largest Contentful Paint (LCP).

Setting page metadata dynamically based on user or route data

NextJS

export async function generateMetadata() {
  return { title: 'Static or cached title' };
}

// Fetch dynamic data on client or use ISR to update metadata periodically

Using static or cached metadata avoids blocking server rendering and speeds up LCP.

📈 Performance Gainreduces blocking time to near zero, improves LCP by 100-300ms

Setting page metadata dynamically based on user or route data

NextJS

export async function generateMetadata() {
  const res = await fetch('https://api.example.com/data');
  const data = await res.json();
  return { title: data.title };
}

Fetching data inside generateMetadata blocks the server from sending metadata until the fetch completes, delaying LCP.

📉 Performance Costblocks rendering for 100-300ms depending on API response time

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Dynamic metadata with live fetch	Minimal DOM impact	0 reflows	Blocks initial paint until data arrives	[X] Bad
Static or cached metadata	Minimal DOM impact	0 reflows	Non-blocking paint	[OK] Good

Rendering Pipeline

The generateMetadata function runs on the server during the rendering pipeline before sending HTML to the client. If it waits on async data, it delays Style Calculation and Layout stages.

→Server Data Fetch

→HTML Generation

→Style Calculation

→Layout

⚠️ BottleneckServer Data Fetch inside generateMetadata

Core Web Vital Affected

LCP

This affects the page load speed by controlling when and how metadata is generated and sent to the browser, impacting the Largest Contentful Paint (LCP).

Optimization Tips

1Avoid slow API calls inside generateMetadata to prevent blocking server rendering.

2Use static or cached metadata when possible to speed up LCP.

3Fetch dynamic data client-side or use ISR to update metadata without blocking.

Performance Quiz - 3 Questions

What is the main performance risk of fetching data inside generateMetadata in Next.js?

A It causes excessive client-side JavaScript execution.

B It delays the server from sending metadata, increasing LCP.

C It increases the number of DOM nodes on the page.

D It triggers multiple reflows on the client.

DevTools: Performance

How to check: Record a performance profile while loading the page and look for long tasks or delays before the first contentful paint.

What to look for: Look for server-side blocking time or delayed LCP caused by metadata generation.

Practice

1. What is the main purpose of the generateMetadata function in Next.js?

easy

A. To fetch data on the client after page load

B. To handle client-side routing between pages

C. To create dynamic page titles and descriptions before rendering

D. To style components dynamically using CSS

Solution

1. Step 1: Understand the role of generateMetadata

   This function runs on the server before the page renders to set metadata dynamically.

2. Step 2: Identify its main use

   It is used to create dynamic page titles and descriptions for SEO and relevant info.

3. Final Answer:

   To create dynamic page titles and descriptions before rendering -> Option C

4. Quick Check:

   Dynamic metadata = To create dynamic page titles and descriptions before rendering [OK]

Hint: Remember: generateMetadata sets SEO info before page loads [OK]

Common Mistakes:

• Confusing generateMetadata with client-side data fetching
• Thinking it handles routing or styling
• Assuming it runs on the client

2. Which of the following is the correct syntax to export a generateMetadata function in a Next.js page?

easy

A. export const generateMetadata = () => { document.title = 'Page' }

B. export async function generateMetadata() { return { title: 'Page' } }

C. function generateMetadata() { console.log('metadata') } export generateMetadata

D. export default function generateMetadata() { return Page }

Solution

1. Step 1: Recall correct export syntax

   Next.js expects generateMetadata as an exported async function returning an object with metadata.

2. Step 2: Check each option

   export async function generateMetadata() { return { title: 'Page' } } correctly exports an async function returning an object with a title property.

3. Final Answer:

   export async function generateMetadata() { return { title: 'Page' } } -> Option B

4. Quick Check:

   Correct export syntax = export async function generateMetadata() { return { title: 'Page' } } [OK]

Hint: Use async function returning object for generateMetadata [OK]

Common Mistakes:

• Using default export instead of named export
• Returning JSX instead of an object
• Trying to set document.title inside generateMetadata

3. Given this generateMetadata function, what will be the page title?

export async function generateMetadata({ params }) {
  return { title: `User: ${params.username}` };
}

And the URL is /user/jane.

medium

A. User: jane

B. User: params.username

C. User: undefined

D. User: /user/jane

Solution

1. Step 1: Understand parameter usage

   The function receives params with username from the URL segment.

2. Step 2: Substitute params.username with actual value

   Since URL is /user/jane, params.username is 'jane', so title becomes 'User: jane'.

3. Final Answer:

   User: jane -> Option A

4. Quick Check:

   Dynamic title uses params.username = User: jane [OK]

Hint: URL params fill template strings in generateMetadata [OK]

Common Mistakes:

• Using literal string 'params.username' instead of value
• Assuming params is undefined without route setup
• Confusing URL path with metadata title

4. What is wrong with this generateMetadata function?

export function generateMetadata() {
  return { title: 'Home' }
  console.log('Metadata generated')
}

medium

A. generateMetadata cannot be a named export

B. The function must be async to work

C. The return value must be a string, not an object

D. The console.log runs after return and is unreachable

Solution

1. Step 1: Analyze function flow

   The return statement ends the function immediately, so code after it won't run.

2. Step 2: Identify unreachable code

   The console.log after return is unreachable and will never execute.

3. Final Answer:

   The console.log runs after return and is unreachable -> Option D

4. Quick Check:

   Code after return is unreachable = The console.log runs after return and is unreachable [OK]

Hint: Code after return is ignored, place logs before return [OK]

Common Mistakes:

• Thinking function must be async always
• Expecting return to accept strings only
• Confusing export types

5. You want to create dynamic metadata for a blog post page that shows the post title and author. Which generateMetadata implementation correctly handles this using params and fetch to get post data asynchronously?

hard

A. export async function generateMetadata({ params }) {
const post = await fetch(`/api/posts/${params.id}`).then(res => res.json());
return { title: post.title, description: `By ${post.author}` };
}

B. export function generateMetadata({ params }) {
const post = fetch(`/api/posts/${params.id}`).then(res => res.json());
return { title: post.title, description: `By ${post.author}` };
}

C. export async function generateMetadata() {
const post = await fetch('/api/posts').then(res => res.json());
return { title: post.title, description: post.author };
}

D. export async function generateMetadata({ params }) {
return { title: params.title, description: params.author };
}

Solution

1. Step 1: Identify async data fetching

   To get post data dynamically, generateMetadata must be async and await the fetch call.

2. Step 2: Check usage of params and fetch

   export async function generateMetadata({ params }) { const post = await fetch(`/api/posts/${params.id}`).then(res => res.json()); return { title: post.title, description: `By ${post.author}` }; } correctly awaits fetch with params.id and returns metadata using fetched data.

3. Final Answer:

   export async function generateMetadata({ params }) { const post = await fetch(`/api/posts/${params.id}`).then(res => res.json()); return { title: post.title, description: `By ${post.author}` }; } -> Option A

4. Quick Check:

   Async fetch with params used correctly = export async function generateMetadata({ params }) { const post = await fetch(`/api/posts/${params.id}`).then(res => res.json()); return { title: post.title, description: `By ${post.author}` }; } [OK]

Hint: Use async/await with params to fetch dynamic metadata [OK]

Common Mistakes:

• Not awaiting fetch causing unresolved promises
• Ignoring params and fetching all posts
• Returning params directly without fetching data