---
title: "Troubleshooting Nuxt SEO Utils"
description: "Create minimal reproductions for Nuxt SEO Utils or just experiment with the module."
canonical_url: "https://nuxtseo.com/docs/seo-utils/getting-started/troubleshooting"
last_updated: "2026-05-17T13:26:34.673Z"
---

## 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:

```ts [nuxt.config.ts]
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:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  site: {
    defaultLocale: 'ja'
  }
})
```

See the [I18n Guide](/docs/seo-utils/guides/i18n) 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:

```ts
// 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](/tools/meta-tag-checker) - Validate title and description, preview Google SERP appearance
- [Social Share Debugger](/tools/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](https://stackblitz.com/edit/nuxt-starter-vbay3q?file=app.vue)