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

title: registerLocale
description: Registra una configuración regional para el código del servidor de Next.js App Router con General Translation. Referencia de la API para registerLocale.

---

La función `registerLocale` establece la configuración regional para el contexto de solicitud actual de App Router. Úsala en los Route Handlers y en los manejadores de imágenes de metadatos cuando `next/root-params` no esté disponible. Consulta [Registrar configuraciones regionales de solicitud](/docs/react/nextjs/registering-request-locales) para ver ejemplos de manejadores de solicitud.

`registerLocale` solo funciona en el servidor y no es compatible con Pages Router.

## Descripción general [#overview]

Llama a `registerLocale` antes de cualquier otra función del servidor de `gt-next` dentro del manejador de solicitud.

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

registerLocale('fr');
```

## Parámetros [#parameters]

| Parámetro | Descripción                                                      | Tipo     | Opcional | Predeterminado |
| --------- | ---------------------------------------------------------------- | -------- | -------- | -------------- |
| `locale`  | Configuración regional que se registrará en la solicitud actual. | `string` | No       | —              |

Los valores de configuración regional no compatibles usan el valor de respaldo definido en la configuración regional de General Translation.

## Devuelve [#returns]

**Tipo** `void`

## Ejemplo [#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>);
}
```