# 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 del hook useRegion
---

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


## Descripción general

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

## 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 ninguna región.
* La región puede establecerse mediante el componente [`<RegionSelector>`](/docs/next/api/components/region-selector) o el hook [`useRegionSelector`](/docs/next/api/helpers/use-region-selector).

## Próximos pasos

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