⬆️ upgrade `next-seo` to `v7.1.0` #352

renovate · 2025-10-18T02:14:48Z

This PR contains the following updates:

Package	Change	Age	Confidence
next-seo	`^6.6.0` → `^7.0.0`

Release Notes

garmeeh/next-seo (next-seo)

`v7.1.0`

Compare Source

Minor Changes

d412e2b: Add HowToJsonLd component for structured data support
- New HowToJsonLd component following Schema.org HowTo specification
- Support for HowToStep, HowToSection, HowToDirection, and HowToTip types
- HowToSupply and HowToTool for materials and equipment
- Duration properties (prepTime, performTime, totalTime) in ISO 8601 format
- estimatedCost as string or MonetaryAmount object
- yield as string or QuantitativeValue
- Video support via VideoObject

`v7.0.1`

Patch Changes

1db3648: Add JSDoc comment to internal type guard function

`v7.0.0`

Next SEO v7.0.0 Release Notes

🚨 Important Notice

Next SEO v7 is a complete rewrite with breaking changes throughout the entire API.

We strongly recommend staying on v6 unless you:

Need the new JSON-LD components based on Google's latest specifications
Are starting a new project and want to use the latest architecture
Are willing to completely rewrite your SEO implementation

Version 6 will continue to receive bug fixes and security updates.

📋 Summary

Next SEO v7 represents a ground-up rewrite of the library, modernizing every aspect from tooling to API design. This release focuses on:

Modern developer experience with improved TypeScript support and better tree-shaking
AI-friendly development making it easier to maintain and contribute
Google-specification compliance for all JSON-LD components
Maintains Pages Router support with function-based API

🎯 Why v7?

The web development ecosystem has evolved significantly as well as my skills (I hope) since Next SEO's inception. Version 7 addresses several key challenges:

Maintainability: The previous architecture made it difficult to add new components and keep up with Google's evolving structured data specifications
Modern Tooling: Moving from legacy build tools to modern alternatives for better performance and developer experience
AI-Assisted Development: Set up to be AI agent-friendly, making it easier for contributors to add features and fix bugs
Specification Compliance: All JSON-LD components rebuilt from scratch following Google's latest documentation and also you can easily create your own

✨ Major Improvements

1. Modern Build Tooling

tsup replaces microbundle for faster, more reliable builds
Vitest replaces Jest for lightning-fast unit tests
Playwright replaces Cypress for more stable E2E testing
ESM-first with CommonJS compatibility

2. Enhanced Developer Experience

Full TypeScript rewrite with improved type inference
Better tree-shaking support
Comprehensive documentation for each component
AI-friendly codebase with AGENTS.md and ADDING_NEW_COMPONENTS.md guides

3. Google-Compliant JSON-LD Components

All JSON-LD components have been rebuilt from scratch following Google's structured data gallery specifications:

More accurate schema implementation
Better validation and error messages
Support for latest schema.org properties

4. Simplified Pages Router API

Instead of components that manage Next.js internals, v7 exposes pure functions that you control:

// v6 (old)
import { NextSeo } from "next-seo";
<NextSeo title="My Page" description="..." />;

// v7 (new)
import Head from "next/head";
import { generateNextSeo } from "next-seo/pages";
<Head>{generateNextSeo({ title: "My Page", description: "..." })}</Head>;

💔 Breaking Changes

Complete API Redesign

This is not a drop-in replacement. Every aspect of the API has changed:

Pages Router Changes

Feature	v6	v7
Component	`<NextSeo />`	`generateNextSeo()` function
Default SEO	`<DefaultSeo />`	`generateDefaultSeo()` function
Import	`next-seo`	`next-seo/pages`
Usage	Direct component	Wrap in `<Head>`

App Router Changes

Feature	v6	v7
Usage	Components with `useAppDir={true}`	Direct component usage
Title prop	Not required	Built-in support
Placement	page.js	page.tsx/jsx

JSON-LD Component Changes

All components have completely new APIs. Properties have been renamed, restructured, or removed to match Google's specifications.

🔄 Migration Guide

Basic Pages Router Migration

Before (v6):

// pages/index.tsx
import { NextSeo } from "next-seo";

export default function Home() {
  return (
    <>
      <NextSeo
        title="My Homepage"
        description="Welcome to my website"
        canonical="https://example.com"
        openGraph={{
          url: "https://example.com",
          title: "My Homepage",
          description: "Welcome to my website",
        }}
      />
      <h1>Welcome</h1>
    </>
  );
}

After (v7):

// pages/index.tsx
import Head from "next/head";
import { generateNextSeo } from "next-seo/pages";

export default function Home() {
  return (
    <>
      <Head>
        {generateNextSeo({
          title: "My Homepage",
          description: "Welcome to my website",
          canonical: "https://example.com",
          openGraph: {
            url: "https://example.com",
            title: "My Homepage",
            description: "Welcome to my website",
          },
        })}
      </Head>
      <h1>Welcome</h1>
    </>
  );
}

JSON-LD Migration Example

Before (v6):

import { ArticleJsonLd } from "next-seo";

<ArticleJsonLd
  url="https://example.com/article"
  title="Article headline"
  images={["https://example.com/image.jpg"]}
  datePublished="2024-01-01"
  authorName="John Doe"
  publisherName="Example News"
  publisherLogo="https://example.com/logo.jpg"
  description="Article description"
/>;

After (v7):

import { ArticleJsonLd } from "next-seo";

<ArticleJsonLd
  url="https://example.com/article"
  headline="Article headline" // Changed from 'title'
  image="https://example.com/image.jpg" // Changed from 'images'
  datePublished="2024-01-01T00:00:00.000Z" // ISO 8601 format recommended
  author="John Doe" // Changed from 'authorName'
  publisher={{
    // Now an object instead of separate props
    "@&#8203;type": "Organization",
    name: "Example News",
    logo: "https://example.com/logo.jpg",
  }}
  description="Article description"
/>;

🛠️ Technical Improvements

Build System

tsup: Modern bundler with better ESM/CJS dual package support
Path aliases: Cleaner imports with ~ mapping to src
Optimized output: Smaller bundle sizes with better tree-shaking

Testing Infrastructure

Vitest: 10x faster test execution
Playwright: More reliable E2E tests
React Testing Library: Better integration testing

Developer Tooling

AI-Friendly Documentation: CLAUDE.md and ADDING_NEW_COMPONENTS.md for AI-assisted development
Modern ESLint: Flat config with latest rules
Prettier Integration: Consistent code formatting
Husky: Pre-commit hooks for quality assurance

📚 Documentation

The documentation has been completely rewritten:

Component-by-component guides with examples
Best practices for each component
Migration guides for common scenarios
AI-friendly contribution guides

🤝 Contributing

Version 7 makes contributing easier than ever:

AI agent-friendly codebase
Comprehensive guide for adding new components
Modern tooling that's familiar to developers
Clear patterns and conventions

🔮 Future Plans

Continue v6 maintenance with bug fixes and security updates
Add more JSON-LD components based on community needs
Further performance optimizations

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
v6 Documentation: Available on the master branch
v7 Documentation: Available on the main branch

⚠️ Final Recommendation

Unless you specifically need the new JSON-LD components or are starting a fresh project, we recommend staying on v6. The API changes are extensive and will require a complete rewrite of your SEO implementation. Version 6 remains stable, battle-tested, and will continue to receive maintenance updates.

Thank you for your continued support of Next SEO. I'm excited about the future of SEO in Next.js applications!

Configuration

📅 Schedule: Branch creation - "every weekend" (UTC), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

vercel · 2025-10-18T02:14:50Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
onruntime-website	Error		Jan 27, 2026 10:54pm

coderabbitai · 2025-12-27T23:53:21Z

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

🔍 Trigger a full review

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

renovate bot added the dependencies Pull requests that update a dependency file label Oct 18, 2025

vercel bot had a problem deploying to Preview October 18, 2025 02:17 Failure

renovate bot force-pushed the renovate/next-seo-7.x branch from 4dfa2ad to cb3dea4 Compare December 27, 2025 23:53

vercel bot had a problem deploying to Preview December 27, 2025 23:56 Failure

renovate bot force-pushed the renovate/next-seo-7.x branch from cb3dea4 to 4cf92b0 Compare December 28, 2025 00:30

vercel bot had a problem deploying to Preview December 28, 2025 00:32 Failure

renovate bot added the breaking label Dec 28, 2025

renovate bot changed the title ~~⬆️ upgrade next-seo to v7~~ ⬆️ upgrade next-seo to v7.0.1 Dec 28, 2025

renovate bot force-pushed the renovate/next-seo-7.x branch from 4cf92b0 to f872466 Compare December 31, 2025 00:13

vercel bot had a problem deploying to Preview December 31, 2025 00:14 Failure

renovate bot force-pushed the renovate/next-seo-7.x branch from f872466 to 1f66d86 Compare December 31, 2025 04:02

vercel bot had a problem deploying to Preview December 31, 2025 04:04 Failure

renovate bot force-pushed the renovate/next-seo-7.x branch from 1f66d86 to 85379c1 Compare January 8, 2026 16:13

vercel bot had a problem deploying to Preview January 8, 2026 16:15 Failure

renovate bot force-pushed the renovate/next-seo-7.x branch from 85379c1 to 2fd0d4f Compare January 19, 2026 19:14

vercel bot had a problem deploying to Preview January 19, 2026 19:16 Failure

⬆️ upgrade next-seo to v7.1.0

809668b

renovate bot changed the title ~~⬆️ upgrade next-seo to v7.0.1~~ ⬆️ upgrade next-seo to v7.1.0 Jan 27, 2026

renovate bot force-pushed the renovate/next-seo-7.x branch from 2fd0d4f to 809668b Compare January 27, 2026 22:51

vercel bot had a problem deploying to Preview January 27, 2026 22:54 Failure

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

⬆️ upgrade `next-seo` to `v7.1.0` #352

⬆️ upgrade `next-seo` to `v7.1.0` #352

Uh oh!

renovate bot commented Oct 18, 2025 •

edited

Loading

Uh oh!

vercel bot commented Oct 18, 2025 •

edited

Loading

Uh oh!

coderabbitai bot commented Dec 27, 2025 •

edited

Loading

Review skipped

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

0 participants

Uh oh!

⬆️ upgrade next-seo to v7.1.0 #352

Are you sure you want to change the base?

⬆️ upgrade next-seo to v7.1.0 #352

Uh oh!

Conversation

renovate bot commented Oct 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release Notes

v7.1.0

Minor Changes

v7.0.1

Patch Changes

v7.0.0

Next SEO v7.0.0 Release Notes

🚨 Important Notice

📋 Summary

🎯 Why v7?

✨ Major Improvements

1. Modern Build Tooling

2. Enhanced Developer Experience

3. Google-Compliant JSON-LD Components

4. Simplified Pages Router API

💔 Breaking Changes

Complete API Redesign

Pages Router Changes

App Router Changes

JSON-LD Component Changes

🔄 Migration Guide

Basic Pages Router Migration

Before (v6):

After (v7):

JSON-LD Migration Example

Before (v6):

After (v7):

🛠️ Technical Improvements

Build System

Testing Infrastructure

Developer Tooling

📚 Documentation

🤝 Contributing

🔮 Future Plans

📞 Support

⚠️ Final Recommendation

Configuration

Uh oh!

vercel bot commented Oct 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot commented Dec 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

0 participants

⬆️ upgrade `next-seo` to `v7.1.0` #352

⬆️ upgrade `next-seo` to `v7.1.0` #352

renovate bot commented Oct 18, 2025 •

edited

Loading

`v7.1.0`

`v7.0.1`

`v7.0.0`

vercel bot commented Oct 18, 2025 •

edited

Loading

coderabbitai bot commented Dec 27, 2025 •

edited

Loading