# gt-next: General Translation Next.js SDK: loadTranslations
URL: https://generaltranslation.com/es/docs/next/api/config/load-translations.mdx
---
title: loadTranslations
description: Referencia de la API para la función loadTranslations()
---

## Resumen

Usa `loadTranslations` para especificar cómo se cargan las traducciones.
De forma predeterminada, tu aplicación cargará las traducciones desde la CDN de GT en producción.
Puedes especificar una función `loadTranslations` para cargar traducciones desde una fuente distinta, como:

* Desde el bundle de tu aplicación (lo más habitual)
* Desde una base de datos
* Desde una API
* Desde una CDN diferente

Ofrecemos compatibilidad integrada para cargar traducciones desde archivos locales incluidos en el bundle de tu aplicación.
Sigue [esta guía](/docs/next/guides/local-tx) para configurar traducciones locales en tu aplicación de Next.js.

Si quieres definir manualmente tus propias traducciones, consulta la [guía de traducciones personalizadas](/docs/next/concepts/stand-alone)
y la función [`loadDictionary`](/docs/next/api/config/load-dictionary).

## Referencia

### Parámetros

<TypeTable
  type={{
  "locale": {
      type: 'string',
      optional: false,
  },
}}
/>

### Descripción

| Tipo     | Descripción                                                   |
| -------- | ------------------------------------------------------------- |
| `locale` | La configuración regional cuyas traducciones se deben cargar. |

### Devuelve

Una `Promise<any>` que se resuelve con un diccionario que asigna identificadores a traducciones para la configuración regional especificada.

***

## Configuración

Define `loadTranslations` como la exportación predeterminada de un archivo llamado `loadTranslations.js` o `loadTranslations.ts`, ya sea en el directorio `src/` o en la raíz.
Asegúrate de que la función devuelva una promesa que se resuelva en un objeto con las traducciones para la configuración regional indicada.

```js title="src/loadTranslations.js"
export default async function loadTranslations(locale) {
  const translations = await import(`../public/locales/${locale}.json`);
  return translations.default;
};
```

Si quieres usar otro nombre o ruta, pasa la ruta relativa mediante el parámetro `loadTranslationsPath` de [`withGTConfig`](/docs/next/api/config/with-gt-config).

***


## Ejemplos

### Cargar traducciones desde tu bundle

```js title="src/loadTranslations.js"
export default async function loadTranslations(locale) {
  const translations = await import(`../public/locales/${locale}.json`);
  return translations.default;
};
```

Cuando está configurado para usar [traducciones locales](/docs/next/guides/local-tx), el comando [`gt translate`](/docs/cli/translate)
guardará las traducciones en el árbol de archivos del proyecto.

```bash
npx gt translate
```


### Carga traducciones desde una CDN

```js title="loadTranslations.js"
export default async function loadTranslations(locale) {
  try {
    const translations = await fetch(`https://your-cdn.com/translations/${locale}.json`);
    const data = await translations.json();
    return data;
  } catch (e) {
    console.error(e);
    return {};
  }
};
```


### Carga las traducciones desde tu propia base de datos

```js title="loadTranslations.js"
export default async function loadTranslations(locale) {
  try {
    const translations = await prisma.translation.findUnique({
      where: {
        locale: locale,
      },
    });
    return translations;
  } catch (e) {
    console.error(e);
    return {};
  }
};
```

<Callout>
  **Pregunta:** ¿Cuál es la diferencia entre [`loadTranslations`](/docs/next/api/config/load-translations) y [`loadDictionary`](/docs/next/api/config/load-dictionary)?

  * [`loadTranslations`](/docs/next/api/config/load-translations) se usa para definir un comportamiento de carga personalizado para las traducciones de tu aplicación.
    Puede obtenerlas desde una CDN, una base de datos o el bundle de tu aplicación.
    Normalmente son traducciones generadas por máquina, gestionadas por la herramienta CLI, y no resultan muy cómodas de editar para los usuarios.
  * [`loadDictionary`](/docs/next/api/config/load-dictionary) está pensado para implementaciones de `gt-next` como biblioteca autónoma.
    Los usuarios aportan sus propias traducciones y no se utiliza ninguna infraestructura de traducción.
</Callout>

***


## Notas

* `loadTranslations` te permite personalizar cómo se cargan las traducciones en tu aplicación en producción.
* Su uso más habitual es añadir [traducciones locales](/docs/next/guides/local-tx)

## Próximos pasos

* Descubre por qué podrías querer usar [traducciones locales](/docs/next/guides/local-tx)
* Añade tus propias traducciones con la [guía de traducciones personalizadas](/docs/next/concepts/stand-alone)