Troubleshooting Nuxt SEO Utils

Common Issues

Meta Tags Missing in Production

Problem: Meta tags work in development but are missing in production.

Solution: Check the following:

1. Ensure you're using SSR (not SPA mode)
2. Run pnpm build and check the generated HTML
3. Enable debug mode to see what's being set:

export default defineNuxtConfig({
  seo: {
    debug: true
  }
})

lang Attribute Not Applied

Problem: You set htmlAttrs: { lang: 'ja' } in useHead() but the HTML element still shows lang="en".

Why: When automaticDefaults is enabled (default), the module automatically sets the lang attribute based on site config, not from useHead() calls.

Solution: Set the locale via site config instead:

export default defineNuxtConfig({
  site: {
    defaultLocale: 'ja'
  }
})

See the I18n Guide for detailed information.

Canonical URL Not Using My Custom Logic

Problem: You're setting a custom canonical URL with useHead() but the module overrides it.

Why: The module sets canonical URLs with low priority by default when automaticDefaults is enabled.

Solution: Either disable automatic defaults or use higher priority:

// Option 1: Higher priority
useHead({
  link: [{ rel: 'canonical', href: 'https://example.com/custom' }]
}, { tagPriority: 'high' })

// Option 2: Disable automatic defaults
export default defineNuxtConfig({
  seo: {
    automaticDefaults: false
  }
})

Debugging Tools

• Meta Tag Checker - Validate title and description, preview Google SERP appearance
• Social Share Debugger - Debug OG images and social cards

Submitting an Issue

When submitting an issue, it's important to provide as much information as possible.

The easiest way to do this is to create a minimal reproduction using the Stackblitz playgrounds:

• Basic