---
title: "I18n Integration"
description: "How to use the Nuxt Site Config module with @nuxtjs/i18n or nuxt-i18n-micro."
canonical_url: "https://nuxtseo.com/docs/site-config/guides/i18n"
last_updated: "2026-05-25T10:39:32.305Z"
---

Site Config integrates automatically with both [@nuxtjs/i18n](https://i18n.nuxtjs.org/) and [nuxt-i18n-micro](https://nuxt.com/modules/nuxt-i18n-micro). No extra configuration is needed; the integration is detected and enabled when either module is installed.

## Usage

The following properties are extracted from your i18n module config:

- `url` - The base URL, configured as `baseUrl` in the i18n module.
- `defaultLocale` - The default locale `language` (e.g. `en-US`) resolved from the i18n module config.
- `currentLocale` - The current locale for the request, resolved from the locale's `language` property. Falls back to `defaultLocale` if no locale is set.

For example, consider the following config:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  i18n: {
    baseUrl: 'https://example.com',
    defaultLocale: 'en',
    locales: [
      { code: 'en', language: 'en-US' },
      { code: 'fr', language: 'fr-FR' },
    ],
  },
})
```

The following site config will be inferred:

```json
{
  "url": "https://example.com",
  "defaultLocale": "en-US",
  "currentLocale": "en-US"
}
```

## Translated Site Config

Both `@nuxtjs/i18n` and `nuxt-i18n-micro` support providing translated site config values through a `nuxtSiteConfig` translation key:

- `name` - Name of the site
- `description` - Description of the site

For example:

<code-group>

```ts [locales/en.ts]
export default {
  nuxtSiteConfig: {
    name: 'My Site',
    description: 'My site description',
  }
}
```

```json [locales/en.json]
{
  "nuxtSiteConfig": {
    "name": "My Site",
    "description": "My site description"
  }
}
```

</code-group>

The following site config will be inferred for an English request:

```json
{
  "url": "https://example.com",
  "defaultLocale": "en-US",
  "currentLocale": "en-US",
  "name": "My Site",
  "description": "My site description"
}
```

## Module Ordering

Ensure your i18n module is listed **before** `nuxt-site-config` (or `@nuxtjs/seo`) in the modules array:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  modules: [
    '@nuxtjs/i18n', // or 'nuxt-i18n-micro'
    'nuxt-site-config', // or '@nuxtjs/seo'
  ],
})
```