# General Translation React SDKs (gt-react, gt-next): useRegion
URL: https://generaltranslation.com/es/docs/react/reference/hooks/use-region.mdx
---

title: useRegion
description: Lee la región activa con General Translation gt-react. Referencia de la API de useRegion.

---

El `hook` `useRegion` devuelve la región seleccionada actualmente por el usuario desde el contexto de [`<GTProvider>`](/docs/react/reference/components/gt-provider), o `undefined` si no se ha configurado ninguna.

*Disponible en `gt-react`, `gt-next` y `gt-react-native`. Los ejemplos importan desde `gt-react`; en su lugar, importa desde el paquete de tu framework.*

*Nota: no se exporta desde `gt-tanstack-start`.*

## Descripción general [#overview]

Usa `useRegion` para consultar el código de la región activa.

```tsx
import { useRegion } from 'gt-react';

export default function RegionDisplay() {
  const region = useRegion(); // [!code highlight]
  return <p>Current region: {region ?? 'Not set'}</p>;
}
```

*Nota: En `gt-react`, usa `useRegion` dentro de un [`<GTProvider>`](/docs/react/reference/components/gt-provider). En `gt-next`, también funciona en componentes de servidor síncronos.*

## Cómo funciona [#how-it-works]

La región se configura mediante el componente [`<RegionSelector>`](/docs/react/reference/components/region-selector) o el hook [`useRegionSelector`](/docs/react/reference/hooks/use-region-selector). Si el usuario no ha seleccionado una región, el hook devuelve `undefined`.

## Devuelve [#returns]

**Tipo** `string | undefined`

El código de la región activa, como `US` o `CA`, o `undefined` si no se ha establecido ninguna región.

## Notas [#notes]

* En un componente async de App Router, usa [`getRegion`](/docs/react/nextjs/reference/functions/get-region) en su lugar.
* Para cambiar la región, usa [`useSetRegion`](/docs/react/reference/hooks/use-set-region) o [`<RegionSelector>`](/docs/react/reference/components/region-selector).