---
title: "Nuxt Config"
description: "The Nuxt OG Image module configuration."
canonical_url: "https://nuxtseo.com/docs/og-image/v5/api/config"
last_updated: "2026-09-06T01:15:21.133Z"
---

### `enabled`

- Type: `boolean`{lang="ts"}
- Default: `true`{lang="ts"}

Conditionally toggle the module.

### `defaults`

- Type: `OgImageOptions`{lang="ts"}
- Default: `{ width: 1200, height: 600, emojis: 'noto', renderer: 'satori', component: 'NuxtSeo', cacheMaxAgeSeconds: 60 * 60 * 24 * 3 }`{lang="ts"}

The default options to use when generating images.

See the [defineOgImage](/docs/og-image/api/define-og-image) documentation for more details.

### `compatibility`

- Type: `{ dev?: CompatibilityFlags, runtime?: CompatibilityFlags, prerender?: CompatibilityFlags }`{lang="ts"}
- Default: `{}`{lang="ts"}

Override the compatibility flags.

See the [compatibility](/docs/og-image/guides/compatibility) guide to learn more.

### `fonts`

- Type: `InputFontConfig[]`{lang="ts"}
- Default: `['Inter:400', 'Inter:700']`{lang="ts"}

Fonts families to use when generating images with Satori. When not using Inter it will automatically fetch the font from Google Fonts.

See the [Custom Fonts](/docs/og-image/guides/custom-fonts) documentation for more details.

### `zeroConfig`

- Type: `boolean`{lang="ts"}
- Default: `false`

Enable zero runtime mode. See the [Zero Runtime](/docs/og-image/guides/zero-runtime) documentation for more details.

### `googleFontMirror`

- Type: `string`{lang="ts"}
- Default: `undefined`

Specify a custom Google Fonts mirror host (e.g., your own proxy server that serves TTF fonts).

**Note:** The mirror must serve TTF format fonts for Satori compatibility. Most public CDNs ([bunny.net](http://bunny.net), fontsource, etc.) only serve WOFF2 which is not compatible.

**For China users:** We recommend using local font files via the `fonts` option with `path` instead of relying on mirrors. See the [Custom Fonts](/docs/og-image/guides/custom-fonts#loading-a-local-font-file) guide.

### `satoriOptions`

- Type: `SatoriOptions`{lang="ts"}
- Default: `{}`{lang="ts"}

Options to pass to Satori when generating images. See the [Satori docs](https://github.com/vercel/satori).

### `resvgOptions`

- Type: `ResvgOptions`{lang="ts"}
- Default: `{}`{lang="ts"}

Options to pass to Resvg when generating images. See the [Resvg docs](https://github.com/yisibl/resvg-js).

### `sharpOptions`

- Type: `SharpOptions`{lang="ts"}
- Default: `{}`{lang="ts"}

Options to pass to Sharp when generating images. See the [Sharp docs](https://sharp.pixelplumbing.com/).

### `componentOptions`

- Type: `{ global: boolean }`{lang="ts"}
- Default: `{}`{lang="ts"}

The options to pass to when registering the `<OgImage />`, `<OgImageScreenshot />` components.

### `componentDirs`

- Type: `string[]`{lang="ts"}
- Default: `['OgImage', 'OgImageTemplate']`{lang="ts"}

Extra component directories that should be used to resolve components.

### `runtimeCacheStorage`

- Type: `boolean | (Record<string, any> & { driver: string })`{lang="ts"}
- Default: `true`{lang="ts"}

Modify the cache behaviour.

Passing a boolean will enable or disable the runtime cache with the default options.

Providing a record will allow you to configure the runtime cache fully.

```ts
export default defineNuxtConfig({
  ogImage: {
    runtimeCacheStorage: {
      driver: 'redis',
      host: 'localhost',
      port: 6379,
      password: 'password'
    }
  }
})
```

## `strictNuxtContentPaths`

- Type: `boolean`{lang="ts"}
- Default: `false`{lang="ts"}

Whether the paths within nuxt/content match their real paths. This is useful when you're using the `nuxt/content` module
without documentDriven mode.

### `debug`

- Type: `boolean`{lang="ts"}
- Default: `false`{lang="ts"}

Enables debug logs and a debug endpoint.