chore(deps): update dependency next-seo to v7 #2794

renovate · 2025-10-20T01:55:53Z

This PR contains the following updates:

Package	Change	Age	Confidence
next-seo	`6.8.0` -> `7.0.1`

Release Notes

garmeeh/next-seo (next-seo)

`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 - Between 12:00 AM and 03:59 AM, only on Monday ( * 0-3 * * 1 ) in timezone 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-20T01:55:56Z

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

Project	Deployment	Preview	Updated (UTC)
zag-nextjs	Ready	Preview	Oct 21, 2025 11:55am
zag-solid	Ready	Preview	Oct 21, 2025 11:55am
zag-svelte	Ready	Preview	Oct 21, 2025 11:55am
zag-vue	Ready	Preview	Oct 21, 2025 11:55am
zag-website	Error		Oct 21, 2025 11:55am

💡 Enable Vercel Agent with $100 free credit for automated AI reviews

changeset-bot · 2025-10-20T01:55:59Z

⚠️ No Changeset found

Latest commit: e161884

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

renovate bot added the dependencies label Oct 20, 2025

vercel bot had a problem deploying to Preview – zag-website October 20, 2025 02:10 Failure

vercel bot deployed to Preview – zag-nextjs October 20, 2025 02:11 View deployment

vercel bot deployed to Preview – zag-svelte October 20, 2025 02:12 View deployment

vercel bot deployed to Preview – zag-vue October 20, 2025 02:14 View deployment

vercel bot deployed to Preview – zag-solid October 20, 2025 02:15 View deployment

chore(deps): update dependency next-seo to v7

e161884

renovate bot force-pushed the renovate/next-seo-7.x branch from 7105d38 to e161884 Compare October 21, 2025 11:18

vercel bot deployed to Preview – zag-nextjs October 21, 2025 11:49 View deployment

vercel bot deployed to Preview – zag-solid October 21, 2025 11:51 View deployment

vercel bot deployed to Preview – zag-vue October 21, 2025 11:52 View deployment

vercel bot deployed to Preview – zag-svelte October 21, 2025 11:53 View deployment

vercel bot had a problem deploying to Preview – zag-website October 21, 2025 11:55 Failure

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

chore(deps): update dependency next-seo to v7 #2794

chore(deps): update dependency next-seo to v7 #2794

Uh oh!

renovate bot commented Oct 20, 2025

Uh oh!

vercel bot commented Oct 20, 2025 •

edited

Loading

Uh oh!

changeset-bot bot commented Oct 20, 2025 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

0 participants

Uh oh!

chore(deps): update dependency next-seo to v7 #2794

Are you sure you want to change the base?

chore(deps): update dependency next-seo to v7 #2794

Uh oh!

Conversation

renovate bot commented Oct 20, 2025

Release Notes

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 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

⚠️ No Changeset found

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

0 participants

`v7.0.1`

`v7.0.0`

vercel bot commented Oct 20, 2025 •

edited

Loading

changeset-bot bot commented Oct 20, 2025 •

edited

Loading