Getting Current Locale

The current locale is exposed on pageContext.locale after the plugin resolves the request.

In Vike hooks

function onBeforeRender(pageContext: Vike.PageContext) {
  const locale = pageContext.locale
}

Through useI18nRoute()

In components, pass pageContext directly:

import { usePageContext } from 'vike-vue/usePageContext'
import { useI18nRoute } from 'vike-i18n-routing'

const { locale, localeMeta } = useI18nRoute(usePageContext())
const localeCurrency = localeMeta?.currency

See useI18nRoute for the full API.

localeDetector

Use localeDetector when locale should be derived from your own app state before fallback detection runs, or when you need to disable specific built-in detection sources.

// +config
i18n: {
  localeDetector(pageContext) {
    if (pageContext.session?.locale) return pageContext.session.locale
    return null
  },
}

Return a locale code to stop detection.

Return null or undefined to continue with the built-in flow.

You can also pass an object to disable specific built-in sources:

// +config
i18n: {
  localeDetector: {
    acceptLanguageHeader: false,
    localeCookie: false,
    session: true,
  },
}

Flags default to true. Setting a flag to false skips that source.

debug

Locale negotiation logging is enabled by default on the dev server. Set debug: true to force it on, or debug: false to force it off.

// +config
i18n: {
  debug: true,
}

Example output:

[vike-i18n-routing] locale resolved: ru
[vike-i18n-routing]   ✗ localeDetector fn -> null
[vike-i18n-routing]   ✓ cookie 'i18n-locale' -> 'ru'

Detection order

For requests without an explicit locale prefix, locale resolution checks:

1. localeDetector(pageContext) if localeDetector is a function
2. locale cookie unless localeDetector.localeCookie === false
3. session.locale unless localeDetector.session === false
4. Accept-Language unless localeDetector.acceptLanguageHeader === false
5. defaultLocale

Locale cookie

The resolved locale is persisted in a cookie (i18n-locale by default, configurable via localeCookie) on every rendered page and on every redirect the plugin issues, so the next request without a locale prefix resolves to the same locale.

To switch locale, link to a prefixed URL. A canonical path under a locale prefix redirects to its translated form and stores that locale: /ru/about redirects to /ru/o-nas with Set-Cookie: i18n-locale=ru, and /en/about (with prefixDefaultLocale: false) redirects to /about with Set-Cookie: i18n-locale=en.

Next: Usage On Client