# gt-react: General Translation React SDK: useRegion
URL: https://generaltranslation.com/es/docs/react/api/helpers/use-region.mdx
---
title: useRegion
description: Referencia de la API del hook useRegion
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. En su lugar, edita el template en content/docs-templates/. */}


## Descripción general

El Hook `useRegion` obtiene la región que el usuario tiene seleccionada actualmente del [contexto de `<GTProvider>`](/docs/react/api/components/gtprovider).

<Callout>
  `useRegion` es un Hook del lado del cliente y *solo puede usarse en componentes del lado del cliente*.
  Asegúrate de que tu aplicación esté envuelta en un [`<GTProvider>`](/docs/react/api/components/gtprovider).
</Callout>

## Referencia

### Devuelve

`cadena | undefined` — El código de región activo en ese momento (p. ej., `"US"`, `"CA"`), o `undefined` si no se ha establecido ninguna región.

***

## Ejemplos

### Uso básico

```jsx title="RegionDisplay.jsx" copy
'use client';
import { useRegion } from 'gt-react';

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

***


## Notas

* Devuelve `undefined` si el usuario no ha seleccionado una región.
* La región puede configurarse con el componente [`<RegionSelector>`](/docs/react/api/components/region-selector) o el Hook [`useRegionSelector`](/docs/react/api/helpers/use-region-selector).

## Siguientes pasos

* Usa [`<RegionSelector>`](/docs/react/api/components/region-selector) para que los usuarios puedan elegir su región.
* Usa [`useRegionSelector`](/docs/react/api/helpers/use-region-selector) para crear un selector de región personalizado.