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

title: resolveCanonicalLocale
description: Risolve un alias di impostazione regionale configurato nel codice server di Next.js App Router con General Translation. Riferimento API per resolveCanonicalLocale.

---

La funzione `resolveCanonicalLocale` converte un'impostazione regionale o un alias configurato nel relativo codice locale canonico BCP 47. Importala da `gt-next/server` nel codice server di App Router.

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

## Panoramica [#overview]

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

const locale = resolveCanonicalLocale('brand-french'); // 'fr-FR'
```

## Parametri [#parameters]

| Parametro | Descrizione                         | Type     | Facoltativo | Predefinito |
| --------- | ----------------------------------- | -------- | ----------- | ----------- |
| `locale`  | Codice locale o alias da risolvere. | `string` | No          | —           |

## Restituisce [#returns]

**Tipo** `string`

L'impostazione regionale canonica configurata per questo valore. Gli alias personalizzati derivano da [`customMapping`](/docs/react/reference/config#custom-mapping).

## Esempio [#example]

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

resolveCanonicalLocale('en-us'); // 'en-US'
```