Nuxt SEO — Full Suite
Best-practices guide for the @nuxtjs/seo meta-package and all six modules:
@nuxtjs/sitemap, nuxt-og-image, nuxt-schema-org, nuxt-seo-utils,
nuxt-link-checker, and @nuxtjs/robots.
Also load the nuxt skill for Nuxt core patterns.
ROUTING: Which rule file to load
IF installing @nuxtjs/seo or configuring shared site.url / site.name:
→ Read rules/core-site-config.md
IF working with useHead, useSeoMeta, titleTemplate, or global meta defaults:
→ Read rules/core-meta-tags.md
IF setting up @nuxtjs/robots or configuring robots.txt for the first time:
→ Read rules/core-robots-setup.md
IF generating or customizing a sitemap.xml:
→ Read rules/features-sitemap.md
IF generating Open Graph images (og:image) dynamically:
→ Read rules/features-og-image.md
IF adding structured data / JSON-LD / Schema.org to pages:
→ Read rules/features-schema-org.md
IF working with breadcrumbs, canonical URLs, favicon, or automatic OG tags:
→ Read rules/features-seo-utils.md
IF checking for broken links in dev or CI:
→ Read rules/features-link-checker.md
IF controlling crawling per page, route, or dynamically at runtime:
→ Read rules/features-page-control.md
IF adding or referencing llms.txt for AI tool documentation access:
→ Read rules/features-llms-txt.md
Rule index
| Topic |
Description |
File |
| Sections overview |
Categories and reading order |
rules/_sections.md |
| Site config |
@nuxtjs/seo install, shared site.url/name/description, env config |
rules/core-site-config.md |
| Meta tags |
useSeoMeta, useHead, app.head defaults, titleTemplate |
rules/core-meta-tags.md |
| Robots setup |
Installation, nuxt.config.ts, disallow, blockNonSeoBots, blockAiBots |
rules/core-robots-setup.md |
| Sitemap |
Auto-generation, dynamic URLs, i18n, multi-sitemap, debug |
rules/features-sitemap.md |
| OG Image |
nuxt-og-image, templates, renderers, prerendering |
rules/features-og-image.md |
| Schema.org |
nuxt-schema-org, identity, useSchemaOrg, schema types |
rules/features-schema-org.md |
| SEO Utils |
Breadcrumbs, canonical, favicon, automatic OG tags |
rules/features-seo-utils.md |
| Link Checker |
Dev/CI broken link detection, rules, reporting, exclusions |
rules/features-link-checker.md |
| Page control |
definePageMeta robots, route rules, useRobotsRule, X-Robots-Tag |
rules/features-page-control.md |
| llms.txt |
Standard, manual public/ file, nuxtseo.com docs for AI tools |
rules/features-llms-txt.md |
Rule categories by priority
| Priority |
Category |
Impact |
Prefix |
| 1 |
Suite setup & shared config |
CRITICAL |
core- |
| 1 |
Meta tags & head management |
CRITICAL |
core- |
| 1 |
Robots module setup |
CRITICAL |
core- |
| 2 |
Sitemap generation |
HIGH |
features- |
| 2 |
OG Image generation |
HIGH |
features- |
| 2 |
Schema.org / structured data |
HIGH |
features- |
| 2 |
SEO utils (breadcrumbs, canonical) |
HIGH |
features- |
| 3 |
Link checker |
MEDIUM |
features- |
| 3 |
Per-page crawl control |
MEDIUM |
features- |
| 3 |
llms.txt |
LOW |
features- |
Coverage and maintenance
1---2name: nuxt-seo3description: Full @nuxtjs/seo suite best practices for Nuxt 3 — covers @nuxtjs/sitemap, nuxt-og-image, nuxt-schema-org, nuxt-seo-utils, nuxt-link-checker, @nuxtjs/robots, useSeoMeta, useHead, breadcrumbs, canonical URLs, favicon, og:image, structured data, and llms.txt. Use when the user mentions sitemap, og image, schema.org, useSeoMeta, useHead, breadcrumbs, canonical, link checker, robots.txt, noindex, blockAiBots, llms.txt, or any @nuxtjs/seo module in a Nuxt project.4---56# Nuxt SEO — Full Suite78Best-practices guide for the `@nuxtjs/seo` meta-package and all six modules:9`@nuxtjs/sitemap`, `nuxt-og-image`, `nuxt-schema-org`, `nuxt-seo-utils`,10`nuxt-link-checker`, and `@nuxtjs/robots`.1112> Also load the `nuxt` skill for Nuxt core patterns.1314## ROUTING: Which rule file to load1516**IF installing @nuxtjs/seo or configuring shared site.url / site.name:**17→ Read `rules/core-site-config.md`1819**IF working with useHead, useSeoMeta, titleTemplate, or global meta defaults:**20→ Read `rules/core-meta-tags.md`2122**IF setting up @nuxtjs/robots or configuring robots.txt for the first time:**23→ Read `rules/core-robots-setup.md`2425**IF generating or customizing a sitemap.xml:**26→ Read `rules/features-sitemap.md`2728**IF generating Open Graph images (og:image) dynamically:**29→ Read `rules/features-og-image.md`3031**IF adding structured data / JSON-LD / Schema.org to pages:**32→ Read `rules/features-schema-org.md`3334**IF working with breadcrumbs, canonical URLs, favicon, or automatic OG tags:**35→ Read `rules/features-seo-utils.md`3637**IF checking for broken links in dev or CI:**38→ Read `rules/features-link-checker.md`3940**IF controlling crawling per page, route, or dynamically at runtime:**41→ Read `rules/features-page-control.md`4243**IF adding or referencing llms.txt for AI tool documentation access:**44→ Read `rules/features-llms-txt.md`4546## Rule index4748| Topic | Description | File |49|-------|-------------|------|50| Sections overview | Categories and reading order | [rules/_sections.md](rules/_sections.md) |51| Site config | @nuxtjs/seo install, shared site.url/name/description, env config | [rules/core-site-config.md](rules/core-site-config.md) |52| Meta tags | useSeoMeta, useHead, app.head defaults, titleTemplate | [rules/core-meta-tags.md](rules/core-meta-tags.md) |53| Robots setup | Installation, nuxt.config.ts, disallow, blockNonSeoBots, blockAiBots | [rules/core-robots-setup.md](rules/core-robots-setup.md) |54| Sitemap | Auto-generation, dynamic URLs, i18n, multi-sitemap, debug | [rules/features-sitemap.md](rules/features-sitemap.md) |55| OG Image | nuxt-og-image, templates, renderers, prerendering | [rules/features-og-image.md](rules/features-og-image.md) |56| Schema.org | nuxt-schema-org, identity, useSchemaOrg, schema types | [rules/features-schema-org.md](rules/features-schema-org.md) |57| SEO Utils | Breadcrumbs, canonical, favicon, automatic OG tags | [rules/features-seo-utils.md](rules/features-seo-utils.md) |58| Link Checker | Dev/CI broken link detection, rules, reporting, exclusions | [rules/features-link-checker.md](rules/features-link-checker.md) |59| Page control | definePageMeta robots, route rules, useRobotsRule, X-Robots-Tag | [rules/features-page-control.md](rules/features-page-control.md) |60| llms.txt | Standard, manual public/ file, nuxtseo.com docs for AI tools | [rules/features-llms-txt.md](rules/features-llms-txt.md) |6162## Rule categories by priority6364| Priority | Category | Impact | Prefix |65|----------|----------|--------|--------|66| 1 | Suite setup & shared config | CRITICAL | `core-` |67| 1 | Meta tags & head management | CRITICAL | `core-` |68| 1 | Robots module setup | CRITICAL | `core-` |69| 2 | Sitemap generation | HIGH | `features-` |70| 2 | OG Image generation | HIGH | `features-` |71| 2 | Schema.org / structured data | HIGH | `features-` |72| 2 | SEO utils (breadcrumbs, canonical) | HIGH | `features-` |73| 3 | Link checker | MEDIUM | `features-` |74| 3 | Per-page crawl control | MEDIUM | `features-` |75| 3 | llms.txt | LOW | `features-` |7677## Coverage and maintenance7879- Coverage map: `rules/_coverage-map.md`80- Suite source: https://github.com/harlan-zw/nuxt-seo81- Docs: https://nuxtseo.com82- Update when `@nuxtjs/seo` releases a new major version.
display-design-studio