Contentful
Conecta Contentful, un CMS headless y plataforma de contenido componible, con Webflow para gestionar contenido estructurado, sincronizar entradas con colecciones del CMS y ofrecer contenido localizado en todas tus páginas.
El CMS de Webflow va de perlas para entradas de blog, landing pages y colecciones básicas. Pero si tu web pide a gritos un modelado de contenido complejo, distribución multicanal, localización avanzada o flujos de aprobación editorial, el CMS nativo por sí solo se te puede quedar corto.
Contentful entra en juego como una capa de contenido headless para estos casos. Al conectarlo con Webflow, puedes gestionar contenido estructurado desde el editor de Contentful y llevarlo a tus páginas mediante JavaScript en el cliente, sincronización automatizada o integración directa por API, ¡sin tener que republicar la web con cada cambio!
Cómo integrar Contentful con Webflow
¿Qué es Contentful? Contentful es un CMS headless y una plataforma de experiencia digital (DXP) componible. Separa la gestión del contenido de su presentación visual y entrega contenido estructurado a través de APIs REST y GraphQL. Además, incluye modelado visual de contenido, publicaciones adaptadas a diferentes idiomas, lanzamientos programados y más de 110 integraciones en su marketplace.

Combina Contentful con Webflow cuando necesites centralizar el contenido para usarlo en múltiples frontends, o cuando tus flujos de trabajo editoriales requieran etapas de aprobación, control de versiones y una localización que va más allá de las herramientas integradas del CMS. Esta combinación mantiene a Webflow como tu capa de diseño y alojamiento, mientras Contentful se encarga de las operaciones de contenido.
Puedes conectar Contentful con Webflow de 3 formas:
- El SDK de JavaScript de Contentful en elementos de código incrustado (Code Embed) recupera y muestra contenido publicado en el lado del cliente sin necesidad de un servidor backend.
- Las automatizaciones de Zapier, n8n y viaSocket sincronizan las entradas de Contentful con las colecciones del CMS cada vez que el contenido se publica o actualiza.
- La API de datos de Webflow y las APIs de Contentful te dan el control total sobre el mapeo de campos, la sincronización diferencial, la localización y el flujo de archivos multimedia, aunque requieren desarrollo en el servidor.
La mayoría de las implementaciones combinan dos o más de estos métodos dependiendo de la complejidad de tu configuración.
Recupera contenido de Contentful con elementos de código incrustado
Puedes cargar el SDK de JavaScript de Contentful dentro de un elemento Code Embed. El SDK llama a la API de entrega de contenido (Content Delivery API) de Contentful al cargar la página, obtiene las entradas publicadas en formato JSON y las pinta directamente en la pantalla. ¡Olvídate de configurar un servidor backend! Este método viene genial cuando necesitas contenido que cambia a menudo sin complicarte con middleware o flujos de automatización. Eso sí, necesitarás un plan de sitio de pago, ya que el código personalizado no está disponible en el plan Starter gratuito.
Para configurar la integración:
- En Contentful, ve a Settings > API Keys y copia el Space ID y el token de acceso de la Content Delivery API.
- Abre la página donde quieras que aparezca el contenido y añade un elemento Code Embed desde el panel Añadir.
- Pega un script que cargue el SDK de navegador de Contentful desde una CDN e inicialice el cliente con el ID del espacio y el token de acceso.
- Usa
client.getEntries()para recuperar entradas por tipo de contenido e insertar los resultados en los elementos HTML de destino dentro del bloque de código. - Guarda el elemento Code Embed, publica el sitio y verifica que el contenido de Contentful se visualice correctamente en la página en vivo.
Este método admite varios patrones de entrega de contenido:
- Recupera entradas filtradas por tipo de contenido, valores de campo o rangos de fechas utilizando los parámetros de consulta del SDK
- Renderiza campos de texto enriquecido de Contentful como HTML usando el paquete
@contentful/rich-text-html-renderercargado vía CDN - Muestra imágenes de la API de imágenes de Contentful con transformaciones al vuelo de formato, tamaño y calidad
- Pagina grandes conjuntos de contenido con los parámetros
skipylimit(por defecto 100 entradas, máximo 1000 por solicitud)
Cada elemento de incrustación de código admite hasta 50 000 caracteres, por lo que es posible que debas alojar paquetes SDK grandes o lógica de renderizado extensa externamente y cargarlos mediante una etiqueta <script> script.
Carga el SDK globalmente con código personalizado en el encabezado o el cuerpo
Cuando varias páginas necesiten contenido de Contentful, carga el SDK una sola vez en el código del encabezado de tu sitio para no duplicar el mismo script en cada Code Embed. Coloca la inicialización del SDK en el código personalizado de las etiquetas head y body, y deja que los Code Embeds de cada página se encarguen únicamente de pedir y mostrar su contenido específico.
Para cargar el SDK en todo el sitio:
- Entra en Site settings > Custom code.
- En la sección de código del encabezado, añade una etiqueta
<script>que cargue el SDK de navegador de Contentful desdecdn.jsdelivr.net/npm/contentful@latest/dist/contentful.browser.min.js. - Debajo del script del SDK, añade un segundo bloque
<script>que cree el cliente concontentful.createClient({ space: '<space_id>', accessToken: '<access_token>' })y lo asigne a una variable global. - Haz clic en Guardar cambios y publica el sitio.
Esta configuración hace que el cliente esté disponible en todas las páginas y simplifica las incrustaciones a nivel de página.
Vincula campos del CMS a elementos de incrustación de código
Si ya estás usando el CMS, puedes guardar el ID de una entrada de Contentful como un campo de texto plano dentro de un elemento de la colección. Así, un Code Embed colocado en una página de colección o dentro de una Collection List lee el ID del campo del CMS y obtiene dinámicamente la entrada correspondiente de Contentful. De este modo, te ahorras tener que escribir los IDs a mano en cada embed.
Para vincular un campo del CMS en una incrustación de código:
- Crea un campo de texto sin formato en la colección del CMS para almacenar el ID de entrada de Contentful.
- Añade un elemento de incrustación de código en la plantilla de la página de colección o dentro de una lista de colección.
- En el editor de incrustación de código, coloca el cursor donde debería aparecer el ID de entrada, haz clic en el punto morado en esa línea y selecciona el campo del CMS que contiene el ID de Contentful.
- Usa el valor vinculado en una llamada
client.getEntry()para obtener y renderizar la entrada específica de Contentful para cada elemento de la colección.
El token de vinculación se reemplaza por el valor real del campo cuando se renderiza la página, por lo que cada elemento de la colección obtiene su propia entrada de Contentful.
Consideraciones sobre SEO y rendimiento
El contenido cargado a través de JavaScript del lado del cliente se renderiza en el navegador del visitante, no en el servidor. Es posible que los motores de búsqueda no indexen el contenido del lado del cliente con la misma fiabilidad que el HTML renderizado en el servidor. Las funciones de SEO integradas, incluidas las metaetiquetas, los campos de Open Graph y la generación de mapas del sitio, se aplican solo al contenido nativo del CMS, no al contenido obtenido de Contentful e inyectado mediante JavaScript.
Para contenido crítico para el SEO, como entradas de blog y páginas de destino, utiliza el enfoque de sincronización basado en API que se describe a continuación para escribir contenido directamente en las colecciones del CMS. Ese contenido se renderiza en el servidor y es totalmente indexable. El enfoque de incrustación del lado del cliente funciona mejor para contenido que se actualiza con frecuencia y no es crítico para el SEO, como listados de eventos, feeds de productos o paneles autenticados.
Conecta con Zapier, n8n o viaSocket
Las plataformas de automatización pueden sincronizar los cambios de Contentful en las colecciones del CMS sin necesidad de código de middleware personalizado.
Algunos ejemplos de flujos de trabajo explícitos entre Contentful y Webflow incluyen:
- Zapier: Contentful Entry Published -> Webflow Create Live Item y Contentful Updated Entry -> Webflow Update Item
- n8n: las entradas de Contentful se leen a través del nodo nativo de Contentful, y los elementos del CMS de Webflow se crean, actualizan, eliminan o consultan mediante el nodo de Webflow
- viaSocket: Contentful New Entry -> Webflow Create Collection, Contentful New Entry -> Webflow Update Item, Contentful New Entry -> Webflow Find Live Item y Webflow New Form Submission -> Contentful Create Entry
Estas son las acciones disponibles entre plataformas para conectar Contentful con Webflow y viceversa:
- Disparador de entrada publicada en Contentful que crea un elemento activo en el CMS de Webflow
- Disparador de entrada actualizada en Contentful que actualiza un elemento existente en el CMS
- Disparador de nuevo envío de formulario en Webflow que crea o publica una entrada en Contentful
La sincronización mediante automatización añade una dependencia de un servicio de terceros que deberás supervisar. Cada plataforma de automatización establece sus propios límites de ejecución y precios, independientes de los planes de Contentful y Webflow. En n8n, el nodo nativo de Contentful es de solo lectura, por lo que para escribir de vuelta en Contentful es necesario llamar a la API de Contentful a través de un nodo de solicitud HTTP.
Desarrolla con las API de Webflow y Contentful
Para el mapeo de campos, la transformación de contenido, la localización y la lógica de sincronización, puedes conectar ambas plataformas a través de sus API REST con un servidor de middleware personalizado. Este enfoque requiere desarrollo del lado del servidor en un host externo, como Netlify Functions, Cloudflare Workers o Vercel, ya que Webflow genera sitios estáticos y no ejecuta código del lado del servidor de forma nativa.
Las API cubren diferentes partes de la integración:
- La Content Delivery API de Contentful lee las entradas publicadas como JSON desde
cdn.contentful.com - La Content Management API de Contentful gestiona webhooks, entradas y recursos multimedia en
api.contentful.com - La Sync API de Contentful recupera solo el contenido modificado desde la última sincronización, ahorrando llamadas a la API en bibliotecas de contenido enormes
- La API de datos de Webflow gestiona colecciones y elementos del CMS, incluyendo operaciones de creación, actualización, eliminación y publicación
- Los webhooks de Webflow disparan eventos en tiempo real para envíos de formularios y cambios en elementos del CMS
Este artículo utiliza los endpoints de la API v2 de Webflow, ya que la v1 quedó obsoleta el 31 de marzo de 2025.
Sincroniza el contenido del CMS con webhooks
La sincronización mediante webhooks es el patrón de API más habitual. Contentful envía un HTTP POST a tu servidor middleware cuando el contenido cambia, y el servidor escribe ese contenido en el CMS.
Para implementar la sincronización por webhooks:
- Registra un webhook en Contentful llamando a
POST https://api.contentful.com/spaces/{space_id}/webhook_definitionscon la URL de tu servidor middleware como destino. Filtra los eventosEntry.publish,Entry.unpublishyEntry.deletedentro del ámbito del entornomaster. - Valida las solicitudes entrantes calculando
HMAC-SHA256(signing_secret, raw_request_body)y comparándolo con la firma del encabezado de Contentful. - Obtén la entrada completa de la API de entrega de contenido (Content Delivery API) usando el
sys.iddel payload del webhook:GET https://cdn.contentful.com/spaces/{space_id}/environments/{env_id}/entries/{entry_id}. - Asigna los campos de Contentful a las claves de
fieldDatade Webflow que coincidan con el esquema de la colección de destino. Los campos de texto enriquecido (Rich Text) de Contentful devuelven JSON, no HTML, así que conviértelos con el paquete@contentful/rich-text-html-rendererantes de escribirlos en los campos de texto enriquecido. - Comprueba si existe un elemento coincidente, ya sea por slug o por ID externo almacenado. Si existe, actualízalo con
PATCH /v2/collections/{collection_id}/items/{item_id}. Si es nuevo, créalo conPOST /v2/collections/{collection_id}/items. - Publica el elemento con .
POST /v2/collections/{collection_id}/items/publish
Los payloads de los webhooks de Contentful usan el tipo de contenido application/vnd.contentful.management.v1+json, no el estándar application/json. Guarda el valor sys.revision de cada payload para poder detectar y omitir entregas duplicadas.
El endpoint de publicación del sitio está limitado a una publicación por minuto. Para actualizaciones de contenido de alta frecuencia, implementa una cola que agrupe los cambios y los publique en intervalos programados en lugar de dispararlos con cada evento de contenido.
Ejecuta una sincronización diferencial para bibliotecas de contenido grandes
La Sync API de Contentful devuelve únicamente lo que ha cambiado desde la última sincronización, ahorrándote un buen puñado de llamadas a la API cuando manejas cientos o miles de entradas.
Para implementar la sincronización diferencial:
- Realiza una llamada de sincronización inicial:
GET https://cdn.contentful.com/spaces/{space_id}/environments/{env_id}/sync?initial=true. Analiza la matrizitemsy guarda el tokennextSyncUrlen un almacenamiento persistente. - Si la respuesta contiene
nextPageUrlen lugar denextSyncUrl, sigue obteniendo datos (las respuestas devuelven hasta 1000 elementos por página). - Clasifica los elementos por
sys.type:Entrylos elementos se insertan o actualizan (upsert) en Webflow,DeletedEntrylos elementos activan una llamadaDELETE /v2/collections/{collection_id}/items/{item_id}/live, yAssetlos elementos se envían a la canalización de sincronización de medios. - Solo sobrescribe el token de sincronización almacenado después de haber procesado el lote completo correctamente.
- En ejecuciones posteriores, llama a
GET .../sync?syncToken={stored_token}para recuperar solo la diferencia (delta).
La API de sincronización devuelve automáticamente todas las variantes de idioma por elemento. La estructura del campo utiliza claves de idioma ({ "en-US": "value", "de-DE": "Wert" }), por lo que tu asignador debe extraer el idioma correcto antes de escribir en Webflow.
Sincroniza contenido localizado
Contentful almacena variantes de idioma dentro de cada entrada. La función de localización de Webflow utiliza IDs de idioma independientes para cada traducción de elementos del CMS.
Para sincronizar contenido localizado:
- Obtén los idiomas de Contentful a través de y los IDs de idioma de Webflow a través de . Crea un objeto de mapeo: .
GET https://api.contentful.com/spaces/{space_id}/environments/{env_id}/localesGET /v2/sites/{site_id}{ "en-US": "webflow_locale_id_en", "de-DE": "webflow_locale_id_de" } - Obtén todas las variantes de idioma de Contentful en una sola llamada añadiendo a la solicitud de entrada.
?locale=* - Itera sobre cada idioma. Busca el correspondiente en Webflow. Omite los idiomas de Contentful que no tengan una contraparte en Webflow.
cmsLocaleId - Crea o actualiza un elemento del CMS por cada idioma y entrada, incluyendo el en el cuerpo de la solicitud.
cmsLocaleId - Publica todos los IDs de elementos devueltos en una sola llamada .
POST /v2/collections/{collection_id}/items/publish
Los códigos de idioma de Contentful, como , no coinciden automáticamente con los identificadores de idioma de Webflow. Necesitas el paso de mapeo para cada sincronización de localización.en-US
¿Qué puedes construir con la integración de Contentful y Webflow?
Integrar Contentful con Webflow te permite gestionar contenido estructurado en un solo sistema y distribuirlo en tus páginas alojadas sin necesidad de duplicar contenido manualmente ni volver a publicar.
- Sitios de marketing multicanal: gestiona el contenido de campañas, descripciones de productos y textos editoriales en Contentful, y luego distribúyelos a tu sitio de marketing, aplicación móvil y plantillas de correo electrónico desde la misma fuente. Una empresa SaaS que gestiona páginas de destino localizadas en cinco mercados actualiza el contenido una vez en Contentful y lo sincroniza con las páginas específicas de cada región a través de la API.
- Blogs editoriales con flujos de trabajo de aprobación: los editores de contenido redactan, revisan y aprueban artículos en el sistema de flujo de trabajo de Contentful, y luego los publican en un blog creado en Webflow mediante la sincronización por webhooks. El sitio recibe las nuevas publicaciones automáticamente y los editores nunca tienen que tocar el CMS directamente.
- Catálogos de productos dinámicos: almacena especificaciones de productos, galerías multimedia y descripciones de características en el modelo de contenido estructurado de Contentful. El middleware de la API escribe los datos del producto en las colecciones del CMS, generando páginas de producto renderizadas en el servidor y totalmente indexables. Los editores actualizan la información del producto sin necesidad de intervención de los desarrolladores.
- Centros de recursos localizados: crea un centro de documentación o de recursos que extraiga contenido específico de cada idioma desde Contentful. Cada entrada contiene traducciones para varios mercados, y la canalización de sincronización escribe la variante correcta en cada idioma. Una empresa con contenido en tres idiomas gestiona todas las traducciones en el editor de Contentful y las publica en Webflow en una sola operación.
Si necesitas más control sobre la transformación de campos, el renderizado de texto enriquecido o las canalizaciones de activos multimedia, la ruta de integración mediante API cubre esos casos con control total.
Preguntas frecuentes
No. Contentful no cuenta con una app listada en el Webflow Apps Marketplace. Las opciones oficiales de integración son los elementos Code Embed, plataformas de automatización como Zapier y n8n, o conexiones directas mediante API. La aplicación de terceros Syncmate incluye Contentful entre sus fuentes de datos compatibles, pero no está desarrollada ni mantenida por Contentful.
El contenido cargado mediante JavaScript en el navegador puede no indexarse con la misma fiabilidad que el HTML renderizado en el servidor. Las funciones de SEO integradas de Webflow solo se aplican al contenido nativo del CMS de Webflow, no al contenido de Contentful obtenido desde el lado del cliente. Para páginas críticas para el SEO, utiliza el enfoque de sincronización por API para escribir el contenido de Contentful directamente en las colecciones del CMS de Webflow, las cuales se renderizan en el servidor y son totalmente indexables.
Los campos de texto enriquecido de Contentful devuelven una estructura JSON propia, no HTML. Convierte el JSON a HTML usando el paquete
@contentful/rich-text-html-renderer. Para los elementos de código incrustado de Webflow en el navegador, carga el renderizador mediante CDN y añadevar exports = {};antes del script del renderizador para evitar un error de referencia en el contexto del navegador. Se necesitan controladores de renderizado personalizados para los recursos y entradas incrustados en el texto enriquecido. Las imágenes incrustadas en el texto enriquecido pueden perder estilos de formato al renderizarse en Webflow, un comportamiento conocido documentado en la comunidad de Webflow.Tanto el método de Code Embed como la inyección de código personalizado requieren un plan de sitio de Webflow de pago. El código personalizado no está disponible en el plan Starter gratuito. Para sincronizar el CMS mediante API, necesitarás un plan con funciones de CMS. Webflow admite hasta 20 000 elementos de CMS en los planes compatibles. Consulta todos los detalles de los planes en webflow.com/pricing.
Contentful aporta valor cuando el modelo de contenido supera lo que el CMS de Webflow admite de forma nativa, como referencias profundamente anidadas, entrega multicanal a plataformas no web, localización en muchos mercados o flujos de trabajo editoriales con aprobaciones en varias etapas. Si el contenido solo aparece en un único sitio de Webflow con una estructura de colección sencilla, el CMS nativo de Webflow evita la complejidad y el coste añadidos de una segunda plataforma. La página de integración de Webflow para Contentful documenta los métodos de integración disponibles, incluidos los elementos de código incrustado, plataformas de automatización como Zapier y n8n, y conexiones directas a la API.
Descripción
Contentful añade gestión de contenido headless a Webflow mediante peticiones del SDK de JavaScript del lado del cliente, plataformas de automatización como Zapier y n8n para la sincronización del CMS, o integración directa vía API para publicaciones activadas por webhooks, sincronización diferencial y entrega de contenido en múltiples idiomas.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.

PowerImporter
Conecta PowerImporter Airtable Sync, una herramienta de sincronización de datos unidireccional, con Webflow para enviar automáticamente el contenido de Airtable a las colecciones de CMS sin escribir código.

AirOps
Conecta AirOps, una plataforma de operaciones de contenido con IA, con Webflow para investigar, redactar y publicar contenido directamente en las colecciones de tu CMS sin tener que cambiar de herramienta.


