# useBrowserLanguage
Package: @mantine/hooks
Import: import { useBrowserLanguage } from '@mantine/hooks';

## Usage

`use-browser-language` returns the browser language from
[navigator.language](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/language):

```tsx
import { Code, Text } from '@mantine/core';
import { useBrowserLanguage } from '@mantine/hooks';

function Demo() {
  const language = useBrowserLanguage();

  return (
    <Text>
      Your browser language: <Code>{language ?? 'unknown'}</Code>
    </Text>
  );
}
```


## usePreferredLanguages

`usePreferredLanguages` returns the user's preferred languages from
[navigator.languages](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/languages), most preferred first.
Use it to pick the best match among the locales your application supports:

```tsx
import { Code, List, Text } from '@mantine/core';
import { usePreferredLanguages } from '@mantine/hooks';

function Demo() {
  const languages = usePreferredLanguages();

  return (
    <>
      <Text mb="xs">Your preferred languages, most preferred first:</Text>
      <List withPadding>
        {languages.map((language) => (
          <List.Item key={language}>
            <Code>{language}</Code>
          </List.Item>
        ))}
      </List>
    </>
  );
}
```


## Definition

```tsx
function useBrowserLanguage(): string | undefined;
function usePreferredLanguages(): readonly string[];
```

## Reacting to changes

Both hooks update the value when the user changes the preferred language in the browser or operating system settings.

## Server-side rendering

On the server and during the first client render, `useBrowserLanguage` returns `undefined`
and `usePreferredLanguages` returns an empty array.
