# General Translation React SDKs (gt-react, gt-next): registerLocale
URL: https://generaltranslation.com/it/docs/react/nextjs/reference/functions/register-locale.mdx
---

title: registerLocale
description: Registra un'impostazione regionale per il codice server di Next.js App Router con General Translation. Riferimento API di registerLocale.

---

La funzione `registerLocale` imposta l'impostazione regionale per il contesto della richiesta corrente di App Router. Usala nei Route Handlers e negli handler delle immagini dei metadati quando `next/root-params` non è disponibile. Consulta [Registrazione delle impostazioni regionali della richiesta](/docs/react/nextjs/registering-request-locales) per esempi di handler.

`registerLocale` è disponibile solo lato server e non funziona con il Pages Router.

## Panoramica [#overview]

Chiama `registerLocale` prima di qualsiasi altra funzione server di `gt-next` nell'handler della richiesta.

```tsx
import { registerLocale } from 'gt-next/server';

registerLocale('fr');
```

## Parametri [#parameters]

| Parametro | Descrizione                                                     | Tipo     | Facoltativo | Predefinito |
| --------- | --------------------------------------------------------------- | -------- | ----------- | ----------- |
| `locale`  | Impostazione regionale da registrare per la richiesta corrente. | `string` | No          | —           |

I valori di impostazione regionale non supportati usano il fallback in base alla configurazione delle impostazioni regionali di General Translation.

## Valore restituito [#returns]

**Tipo** `void`

## Esempio [#example]

```tsx title="app/[locale]/opengraph-image.tsx"
import { ImageResponse } from 'next/og';
import { getGT, registerLocale } from 'gt-next/server';

export default async function Image({ params }) {
  const { locale } = await params;
  registerLocale(locale);

  const gt = await getGT();
  return new ImageResponse(<div>{gt('Welcome')}</div>);
}
```