What Is Nuxt SEO?

Why use Nuxt SEO?

Nuxt SEO is an ecosystem of SEO modules, tools, and tutorials built with and for the Nuxt community. Technical SEO requires many moving parts: sitemaps, robots.txt, Schema.org, OG images, meta tags, broken links. Nuxt SEO provides a module for each, so you can install them individually or all at once.

Start Here

For most Nuxt sites:

1. Install @nuxtjs/seo.
2. Set your production site.url and site.name.
3. Visit /sitemap.xml, /robots.txt, and a real page in production to confirm the generated output.
4. Use the SEO Checklist before launch.

If you only need one feature, install the individual module instead. For example, use @nuxtjs/sitemap when you only need a sitemap.

Features

Crawl Control

Automatic robots.txt generation, <meta name="robots"> tags, and X-Robots-Tag headers to manage how search engines access your site.

• Robots docs

Sitemaps

Auto-generated sitemap.xml from your app's data sources, with multi-sitemap support for i18n sites.

• Sitemap docs

OG Images

Dynamic Open Graph image generation for every page, no manual design work needed.

• OG Image docs

Structured Data

Schema.org JSON-LD generated automatically with sensible defaults and opt-in rich schemas.

• Schema.org docs

Link Checking

Broken link detection at build time with ESLint integration and DevTools support.

• Link Checker docs

SEO Utils

Automatic favicons, default meta tags, breadcrumbs, and social share links.

• SEO Utils docs

AI Discoverability

llms.txt and a Markdown version of every page, so AI agents can read your site.

• AI Ready docs

Skew Protection

Keeps the assets of earlier builds after a deploy, so open tabs stop failing on missing chunks.

• Skew Protection docs

Modules

Every module works standalone. Install only what you need (e.g. Sitemap and Robots), or use @nuxtjs/seo to get all nine modules at once. Configuration, composables, and features are identical either way.

Site Config

All modules need your site URL for canonical links and sitemaps. Site Config ensures all modules share the correct configuration. You do not need to install this module manually; it installs automatically when you install any SEO module.

Set it once:

export default defineNuxtConfig({
  site: {
    url: 'https://example.com',
    name: 'My Site'
  }
})

Every module uses these values. No duplication.

The @nuxtjs/seo Module

The @nuxtjs/seo package installs all nine Nuxt SEO modules in one step. It also checks module versions at build time, and runs setup checks in development.

npx nuxt module add @nuxtjs/seo

// This is almost all it does. Setup also fails the build on an unsupported
// Nuxt version, or when a loaded module is older than its version below.
// In development, it also runs setup checks.
export default defineNuxtModule<ModuleOptions>({
  moduleDependencies: {
    '@nuxtjs/robots': { version: '>=7.0.0' },
    '@nuxtjs/sitemap': { version: '>=9.0.1' },
    'nuxt-link-checker': { version: '>=6.0.0' },
    'nuxt-og-image': { version: '>=7.0.1' },
    'nuxt-schema-org': { version: '>=7.0.0' },
    'nuxt-seo-utils': { version: '>=9.0.0' },
    'nuxt-site-config': { version: '>=5.0.1' },
    'nuxt-skew-protection': {
      version: '>=2.0.1',
      defaults: { updateStrategy: 'polling', cookie: false },
    },
    'nuxt-ai-ready': { version: '>=3.0.1' },
    '@nuxtjs/i18n': { version: '>=10.0', optional: true },
  },
})

@nuxtjs/seo vs individual modules: both approaches give you the exact same modules with the exact same features. The only difference is how you install them.

• Use @nuxtjs/seo if you want all nine modules with a single install. This is the easiest way to get started.
• Install individually if you only need specific modules (e.g. Sitemap and Robots) or want to pin each module to a specific version.
• Skip one module in @nuxtjs/seo by disabling it, for example skewProtection: false.

Going Further

Modules handle the technical foundation, but testing your production environment is as important. Nuxt SEO provides free tools to validate your live site:

Getting Started

1. Install the module: See the Installation guide to add Nuxt SEO to your project
2. Configure your modules: Check out the Using the Modules guide to learn how to configure and use each module
3. Explore individual modules: Each module has its own documentation with detailed configuration options and examples