Nuxt · NUXT0057

Use Nuxt SEO composables for metadata

Reports useHead() calls that set a description, Open Graph, or Twitter meta tag, or only a title, which useSeoMeta() owns.
NUXT0057vite-doctor/nuxtseowarnSuggestion

Run this rule

pnpm nuxt doctor --rules nuxt/seo/prefer-seo-composables

Why it matters

useSeoMeta() provides typed, flat SEO fields and prevents malformed name, property, and content combinations in manual head arrays. Links, html attributes, a title template, and meta such as viewport or charset still belong in useHead(), so a title next to them is not reported.

Move the title, description, og:* and twitter:* tags to useSeoMeta() and keep the rest in useHead().

Example

Use SEO composables

Before

useHead({
  title: 'Home',
  meta: [{ name: 'description', content: 'Welcome' }],
})

After

useSeoMeta({
  title: 'Home',
  description: 'Welcome',
})
Copyright © 2026