Overview

The useDefaultLocale hook retrieves your application's default locale from the <GTProvider> context. This locale represents the fallback language for your app and is typically used when a user's preferred locale is unavailable.

See withGTConfig for configuration. If no default locale is specified in withGTConfig, it defaults to 'en-US'. For server-side usage, see getDefaultLocale.

Reference

Returns

A string representing the application’s default locale, e.g. 'en-US'.

Examples

Basic usage

Retrieve the application’s default locale and display it in your component.

"use client";
import { useDefaultLocale } from 'gt-next';

export default function DefaultLocale() {
    const defaultLocale = useDefaultLocale();

    return <p>Default locale: {defaultLocale}</p>; // Display the default locale
}

Notes

• The useDefaultLocale hook relies on the <GTProvider> to access the context. Ensure your app is wrapped with a provider at the root level.
• useDefaultLocale is client-side only.
• Learn more about locale strings here.

Next steps

• See useLocale and getLocale to retrieve the user’s locale.
• Explore getDefaultLocale for retrieving the default locale in server components.