--- title: "Config" description: "Configuration options for Nuxt SEO Utils module." canonical_url: "https://nuxtseo.com/docs/seo-utils/api/config" last_updated: "2026-05-06T18:43:42.250Z" --- ### `enabled` - Type: `boolean` - Default: `true` Conditionally toggle the module. ### `debug` - Type: `boolean` - Default: `false` Enables debug logs. ## `canonicalQueryWhitelist` - Type: `string[]` - Default: `['page', 'sort', 'filter', 'search', 'q', 'category', 'tag']` When set, only these query parameters are included in the canonical URL. All other query parameters are stripped. ## `canonicalLowercase` - Type: `boolean` - Default: `true` When enabled, the canonical URL will be lowercased. Recommended to keep on for consistency. ## `redirectToCanonicalSiteUrl` - Type: `boolean` - Default: `false` When enabled, it will redirect any request to the canonical domain (site url) using a 301 redirect on non-dev environments. E.g if the site url is '[www.example.com](http://www.example.com)' and the user visits 'example.com', they will be redirected to '[www.example.com](http://www.example.com)'. This is useful for SEO as it prevents duplicate content and consolidates page rank. ## `automaticDefaults` - Type: `boolean` - Default: `true` Will set up a number of defaults for meta tags and Schema.org, if the modules and config are available. ## `mergeWithSiteConfig` - Type: `boolean` - Default: `true` Injects site config into the `useHead` composable such as setting the title template and template params like `%siteName`. ## `fallbackTitle` - Type: `boolean` - Default: `true` Will ensure a title is always set by providing a fallback title based on the casing the last slug segment. ## `metaDataFiles` - Type: `boolean` - Default: `true` Should the files in the public directory be used to infer tags such as favicon, apple-touch-icon, and open graph images. ## `automaticOgAndTwitterTags` - Type: `boolean` - Default: `true` Should head data be inferred from the current input to fill in the gaps. For example: - If you supply a title, this will automatically add an og:title. - If you provide an og:image, it will automatically add a twitter:image. ## `tagPriority` - Type: `number | 'critical' | 'high' | 'low' | \`before:${string}` | `after:${string}``{lang="ts"} - Default: `'low'` Sets the `tagPriority` for SEO and Open Graph meta tags generated by this module. The default `'low'` ensures module tags act as fallbacks that page-level `useSeoMeta()` calls can override. Use a numeric value or `'critical'`/`'high'` to place tags earlier in the `` (useful for OG crawlers with byte limits). ## `minify` - Type: `boolean | { build?: boolean, runtime?: boolean }` - Default: `true` Minifies inline `