better-i18n.com
DocumentaciónCentro de ayudaNovedades

¿Cómo activo el CMS y creo mi primer modelo de contenido?

Actualizado el Aug 21, 2026

El Content CMS es un complemento opcional para gestionar contenido multilingüe estructurado —entradas de blog, artículos de ayuda, notas de versión, descripciones de producto— junto a tus claves de i18n.

¿Necesitas el Content CMS? #

El Content CMS es para contenido de forma libre con estructura rica. Si gestionas cadenas t('key') en tu código, de eso se encarga la Translation API: no necesitas el CMS para ello.

Usa el Content CMS cuando necesites:

  • Artículos o documentos con cuerpo en markdown
  • Contenido con campos personalizados (autor, fecha, categoría)
  • Varias versiones de idioma gestionadas por separado
  • Contenido servido por API o CDN en lugar de empaquetado en tu aplicación

Paso 1: activar el Content CMS #

  1. Entra en tu proyecto desde el panel
  2. Haz clic en la pestaña Content
  3. Si aún no está activo, pulsa «Enable Content CMS»

La pestaña Content está disponible en todos los planes. Algunas funciones avanzadas (modelos personalizados, operaciones masivas) pueden requerir un plan superior.

Paso 2: crear tu primer modelo de contenido #

Un modelo de contenido es el esquema de tu tipo de contenido. Piénsalo como la definición de una tabla de base de datos.

  1. En la pestaña Content, pulsa «New model»
  2. Escribe un nombre (p. ej. «Help Article») y un slug (p. ej. help-article)
  3. Añade campos personalizados:
    • Text — cadenas cortas (títulos, autores)
    • Textarea — textos más largos (extractos, resúmenes)
    • Number — enteros o decimales
    • Boolean — indicadores verdadero/falso
    • Enum — desplegable con una lista fija de valores
    • Relation — referencia a otro modelo de contenido
  4. En los campos que quieras traducir por idioma, activa «Localized»
  5. Pulsa Create model

Hay un ajuste a nivel de modelo que conviene decidir ahora y no después: si las entradas de este modelo llevan cuerpo o no. Los modelos con cuerpo (artículos, publicaciones) exigen contenido no vacío en un idioma antes de poder publicar ese idioma. Los modelos solo de metadatos —etiquetas, categorías y otras taxonomías— se publican únicamente con sus campos.

Paso 3: crear tu primera entrada #

  1. Selecciona tu modelo en la pestaña Content
  2. Pulsa «New entry»
  3. Rellena el título, el cuerpo y los campos personalizados
  4. Pulsa Save o Publish

Tras publicarla, la entrada está disponible en la Content API:

Bash
curl "https://content.better-i18n.com/v1/content/your-org/your-project/models/help-article/entries?status=published" \
  -H "x-api-key: YOUR_API_KEY"

Siguientes pasos #