# 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 el comportamiento de carga de traducciones.
Por defecto, tu aplicación cargará las traducciones desde la CDN de GT en producción.
Puedes especificar una función `loadTranslations` para cargar traducciones desde un origen diferente, como:

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

Hemos integrado compatibilidad 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 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 para la que se deben cargar las traducciones. |

### Devuelve

Una `Promise<any>` que se resuelve en un diccionario que relaciona ID con 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 traducciones para la configuración regional especificada.

```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

### Obtener traducciones de 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 se configura para usar [traducciones locales](/docs/next/guides/local-tx), el comando
[`gt translate`](/docs/cli/translate) guardará las traducciones en la estructura de archivos de tu proyecto.

```bash
npx gt translate
```


### Cargar 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 {};
  }
};
```


### Cargar 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 obtener traducciones para tu aplicación.
    Esto puede implicar obtener traducciones desde una CDN, una base de datos o el bundle de tu aplicación.
    Normalmente, se trata de traducciones generadas automáticamente, gestionadas por la herramienta CLI, y no muy fáciles de editar para los usuarios.
  * [`loadDictionary`](/docs/next/api/config/load-dictionary) está pensado para implementaciones de `gt-next` como una biblioteca independiente.
    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 caso de uso más común es añadir [traducciones locales](/docs/next/guides/local-tx)

## Siguientes pasos

* Descubre por qué te conviene usar [traducciones locales](/docs/next/guides/local-tx)
* Agrega tus propias traducciones con la [guía de traducciones personalizadas](/docs/next/concepts/stand-alone)