# gt-next: General Translation Next.js SDK: useRegion
URL: https://generaltranslation.com/es/docs/next/api/helpers/use-region.mdx
---
title: useRegion
description: Referencia de la API para el hook `useRegion`
---

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


## Resumen

El hook `useRegion` obtiene la región seleccionada actualmente por el usuario del [contexto de `<GTProvider>`](/docs/next/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/next/api/components/gtprovider).
</Callout>

Para usarlo del lado del servidor, consulta [`getRegion`](/docs/next/api/helpers/get-region).

## Referencia

### Devuelve

`string | undefined` — El código de región activo (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-next';

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 establecerse con el componente [`<RegionSelector>`](/docs/next/api/components/region-selector) o el hook [`useRegionSelector`](/docs/next/api/helpers/use-region-selector).

## Siguientes pasos

* Consulta [`getRegion`](/docs/next/api/helpers/get-region) para conocer el equivalente del lado del servidor.
* Usa [`<RegionSelector>`](/docs/next/api/components/region-selector) para permitir que los usuarios elijan su región.
* Usa [`useRegionSelector`](/docs/next/api/helpers/use-region-selector) para crear un selector de región personalizado.