# General Translation React SDKs (gt-react, gt-next, gt-react-native): useSetRegion
URL: https://generaltranslation.com/es/docs/react/reference/hooks/use-set-region.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Cambia la región activa. Referencia de la API de useSetRegion.

El `hook` `useSetRegion` devuelve una función que cambia la región activa. Está disponible del lado del cliente.

*Disponible en `gt-react` y `gt-react-native`.*

*Nota: `gt-next` y `gt-tanstack-start` no lo exportan.*

## Resumen general [#overview]

Llama a `useSetRegion` para obtener la función setter y luego úsala con un código de región.

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

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

export default function RegionButton() {
  const setRegion = useSetRegion();
  return <button onClick={() => setRegion('CA')}>Switch to Canada</button>;
}
```

*Nota: `useSetRegion` está disponible solo del lado del cliente y debe usarse dentro de un [`<GTProvider>`](/docs/react/reference/components/gt-provider).*

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

Al llamar a la función devuelta, la región elegida se guarda en una cookie y la página se recarga para aplicar el formato específico de esa región. Pasar `undefined` borra la región.

## Devuelve [#returns]

**Tipo** `(region: string | undefined) => void`

Una función que establece la región activa con el código indicado o la restablece al pasar `undefined`.

## Notas [#notes]

* `useSetRegion` está disponible del lado del cliente.
* Para consultar la región activa, usa [`useRegion`](/docs/react/reference/hooks/use-region). Si quieres un selector listo para usar, utiliza [`<RegionSelector>`](/docs/react/reference/components/region-selector).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.