# gt-next: General Translation Next.js SDK: getRegion
URL: https://generaltranslation.com/es/docs/next/api/helpers/get-region.mdx
---
title: getRegion
description: Referencia de la API del método getRegion del lado del servidor
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. Edita la plantilla en content/docs-templates/. */}


## Resumen

La función `getRegion` obtiene el código de la región actual del usuario a partir de la cookie de región integrada durante el renderizado del lado del servidor.

<Callout>
  `getRegion` es un método del lado del servidor y solo puede usarse en componentes del servidor.
</Callout>

Para usarlo del lado del cliente, consulta [`useRegion`](/docs/next/api/helpers/use-region).

## Referencia

### Devuelve

`Promise<string | undefined>` — Una promesa que devuelve el código de región del usuario (p. ej., `"US"`, `"CA"`), o `undefined` si no se ha establecido ninguna región.

***

## Ejemplos

### Uso básico

```jsx title="RegionDisplay.jsx" copy
import { getRegion } from 'gt-next/server';

export default async function RegionDisplay() {
  const region = await getRegion(); // [!code highlight]
  return <p>Región actual: {region ?? 'No establecida'}</p>;
}
```

***


## Notas

* `getRegion` es asíncrono y debe esperarse con `await`.
* Devuelve `undefined` si el usuario no ha seleccionado una región.
* La región se almacena en una cookie y se puede establecer con el componente [`<RegionSelector>`](/docs/next/api/components/region-selector) o el hook [`useRegionSelector`](/docs/next/api/helpers/use-region-selector).

## Próximos pasos

* Consulta [`useRegion`](/docs/next/api/helpers/use-region) para conocer el equivalente del lado del cliente.
* Usa [`<RegionSelector>`](/docs/next/api/components/region-selector) para que los usuarios puedan elegir su región.