Nuxt · SEO

NUXT0057Use 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.

Why it happens

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.

Fix

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',
})

Verify the fix

Run only this rule after editing so the report stays focused on the diagnostic you are closing:

pnpm nuxt doctor --rules nuxt/seo/prefer-seo-composables
Copyright © 2026