# What changed in next-seo

> 14 changes in next-seo 7 from its official release notes, upgrade guides and advisories: 7 breaking, 1 security, 5 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/next-seo/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## next-seo 7

### Breaking changes

- App Router components are used directly instead of with useAppDir={true}. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)
- ArticleJsonLd uses author instead of authorName. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)
- ArticleJsonLd uses headline instead of title for the article headline. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)
- ArticleJsonLd uses image instead of images for the article image. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)
- Publisher details are supplied as a publisher object instead of separate publisherName and publisherLogo props. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)
- The Pages Router default SEO API is now a function rather than the DefaultSeo component. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)
- The documented App Router placement changes from page.js to page.tsx/jsx. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)

### Security

- All JSON-LD components accept an optional nonce prop, forwarded to the rendered script tag for CSP compliance. (7.3.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/next-seo%407.3.0)

### New APIs and options

- Adds the `aggregateRating` prop, a direct Schema.org Organization property processed using shared utilities. (7.2.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/next-seo%407.2.0)
- Adds the `review` prop, a direct Schema.org Organization property processed using shared utilities. (7.2.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/next-seo%407.2.0)
- Adds a component for Schema.org HowTo structured data, supporting HowTo steps, sections, directions, tips, supplies, tools, ISO 8601 durations, cost, yield, and video. (7.1.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/next-seo%407.1.0)
- Pages Router SEO is generated with a function from next-seo/pages and rendered inside next/head’s Head component, replacing the NextSeo component. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)
- App Router usage now has built-in title support; the title prop was not required in v6. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)

### Behavior and default changes

- JSON-LD components were rebuilt to follow Google's structured data gallery specifications, with updated schemas, validation, error messages, and support for latest schema.org properties. (7.0.0) — [release notes](https://github.com/garmeeh/next-seo/releases/tag/v7.0.0)