Los equipos suelen elegir esta configuración cuando quieren que Webflow mantenga el control del diseño y la edición de contenido, mientras que React se encarga de las partes de la interfaz que requieren un comportamiento tipo aplicación.
Webflow se encarga de la maquetación, el contenido del CMS de Webflow, el alojamiento y el diseño adaptable sin tocar una sola línea de código. Pero algunas interfaces piden a gritos gestión de estados, renderizado condicional y datos en tiempo real que van más allá de lo que ofrecen sus herramientas visuales. Calculadoras de ROI, formularios multipaso con lógica condicional o visualizaciones de datos en vivo: todo esto necesita sí o sí un framework de JavaScript basado en componentes para cobrar vida.
React llena ese vacío. Al incrustar componentes de React directamente en las páginas de Webflow o al usar Webflow como un CMS headless para un frontend de React, los equipos pueden añadir interactividad con estado a los sitios de marketing sin tener que reconstruirlos desde cero. Los Code Components llevan React al lienzo de Webflow para usarlo mediante arrastrar y soltar, mientras que DevLink exporta los diseños de Webflow como código de React listo para producción.
Esta integración está pensada para desarrolladores frontend que añaden funciones interactivas a sitios alojados en Webflow, agencias que entregan sitios de marketing junto con aplicaciones basadas en React, y equipos de SaaS que necesitan páginas de marketing editables por personas que no son desarrolladores, manteniendo al mismo tiempo un sistema de diseño compartido con el código de su producto.
Cómo integrar React con Webflow
¿Qué es React? React es una biblioteca de JavaScript para el frontend destinada a crear interfaces de usuario, creada por Meta y actualmente gobernada por la React Foundation bajo la Linux Foundation. El antiguo dominio reactjs.org redirige a la documentación oficial en react.dev. Utiliza una arquitectura basada en componentes donde las funciones de JavaScript devuelven marcado, un DOM virtual para el renderizado y hooks como useState y useEffect para gestionar el estado y los efectos secundarios. La versión estable actual es React 19.2, lanzada el 1 de octubre de 2025.

Los equipos usan React con Webflow cuando un sitio de marketing necesita funciones interactivas que las interacciones nativas de Webflow no pueden producir: calculadoras con lógica compleja, paneles que extraen datos de API en vivo o configuradores de productos con renderizado condicional. La integración también funciona en la dirección opuesta, con Webflow sirviendo como capa de diseño y CMS para una aplicación frontend de React o Next.js.
La integración de React y Webflow admite 4 enfoques:
- Los elementos Code Embed gestionan la incrustación de componentes de React directamente en las páginas de Webflow mediante scripts de CDN o paquetes precompilados. Los
- Code Components te permiten importar componentes de React al lienzo visual de Webflow para que los diseñadores los usen arrastrando y soltando. La
- exportación de componentes de DevLink convierte los componentes diseñados en Webflow en código de React listo para producción para usar en proyectos de Next.js, Gatsby o Remix. La
- API de datos de Webflow y React te dan control total sobre la entrega de CMS headless, el manejo de formularios y los datos de comercio electrónico, pero requieren desarrollo del lado del servidor.
La mayoría de las implementaciones combinan dos o más de estos métodos según la complejidad de la configuración.
Añade componentes de React con elementos Code Embed
Incrustar React directamente en una página de Webflow viene de perlas para widgets interactivos, prototipos y componentes independientes que conviven con diseños creados en Webflow. Este truco recurre al código personalizado en las etiquetas head y body para cargar React y montar componentes en rincones específicos de la página. Eso sí, necesitarás un Workspace de pago o un plan de sitio de pago: los planes Starter gratuitos se quedan con las ganas y no admiten código personalizado.
Los componentes de React no se renderizan en el lienzo de Webflow. Todas las pruebas deben realizarse en el sitio publicado o en fase de pruebas. Webflow proporciona cuatro puntos de inyección de código: código en el head de todo el sitio, código en el footer de todo el sitio, código en el footer a nivel de página y elementos Code Embed colocados directamente en el lienzo.
Existen tres submétodos dependiendo de la complejidad del proyecto.
Cargar React mediante CDN
Este método carga React desde una CDN sin ningún paso de compilación. Funciona para widgets interactivos sencillos y prototipos que no requieren paquetes npm.
Para configurar un componente de React cargado mediante CDN:
- Ve a Configuración del sitio > Código personalizado > Código del Head y añade los scripts de CDN de React y ReactDOM desde unpkg.com. Para el desarrollo, añade Babel standalone para admitir la sintaxis JSX en el navegador. Arrastra un elemento
- HTML Embed a la posición deseada en el lienzo y añade un contenedor de montaje vacío:
<div id="react-root"></div>. Ve a - Configuración del sitio > Código personalizado > Código del Footer y añade un script que cree el componente de React y lo monte en el contenedor usando
ReactDOM.createRoot().
Una versión segura para producción utiliza llamadas a React.createElement() en lugar de JSX, eliminando la dependencia de Babel standalone. Babel standalone realiza la transformación de JSX en el navegador y no es adecuado para su uso en producción.
<script> const { useState, createElement } = React; function Counter() { const [count, setCount] = useState(0); return createElement( 'div', null, createElement('p', null, 'Count: ' + count), createElement('button', { onClick: () => setCount(count + 1) }, 'Increment') ); } const domNode = document.getElementById('react-root'); const root = ReactDOM.createRoot(domNode); root.render(createElement(Counter));</script>
El patrón de montaje createRoot() es el enfoque canónico documentado en react.dev. Al usar este método mediante scripts CDN, solo se pueden utilizar los paquetes disponibles como etiquetas <script> de CDN; los paquetes de npm no están disponibles sin un paso de compilación independiente.
Integrar un paquete de React precompilado
Para árboles de componentes de React completos que utilicen JSX y paquetes de npm, compila la aplicación externamente con Vite, webpack o Rollup, y luego carga el paquete compilado en Webflow.
Para integrar una aplicación de React compilada:
- Configura el empaquetador para generar un formato IIFE. En una configuración de Vite, establece
build.lib.formatsen['iife']y empaqueta React en el resultado, ya que el entorno de Webflow no tiene un React global. - Escribe un punto de entrada de montaje que importe
createRootdesdereact-dom/clienty renderice la aplicación en un elemento DOM de destino. - Aloja el paquete compilado externamente. El límite de 50,000 caracteres por campo de código hace que incluir un paquete de producción directamente sea poco práctico. Usa GitHub con jsDelivr CDN, Netlify, Vercel o el panel de Assets de Webflow.
- Arrastra un elemento Code Embed al lienzo y añade
<div id="react-target"></div>. - En Site Settings > Custom Code > Footer Code, añade una etiqueta
<script>que apunte al paquete alojado condeferpara evitar bloquear la renderización de la página.
<script
src="https://cdn.jsdelivr.net/gh/yourusername/yourrepo@main/dist/my-app.iife.js"
defer>
</script>
La manipulación del DOM por parte de React puede romper el sistema de animaciones de Webflow (IX2). Reinicialízalo después de que React se monte llamando a window.Webflow?.require('ix2').init() una vez tras el montaje inicial — las llamadas repetidas degradan el rendimiento.
Integrar una aplicación de React completa mediante iframe
Para aplicaciones de una sola página (SPA) de React completas —paneles, formularios complejos o herramientas con muchos datos—, un iframe proporciona un aislamiento total del CSS y JavaScript de Webflow.
Para integrar mediante iframe:
- Compila y despliega la aplicación de React en un host estático como Netlify, Vercel o GitHub Pages.
- Arrastra un elemento Code Embed al lienzo y añade una etiqueta
<iframe>que apunte a la URL de la aplicación desplegada. - Implementa el ajuste de altura dinámico usando
postMessageentre el iframe y la página principal de Webflow.
El contenido dentro de los iframes generalmente no es indexado por los motores de búsqueda. Las interacciones de Webflow no pueden afectar al contenido del iframe y las hojas de estilo de Webflow no se aplican dentro de él. Este método funciona mejor para paneles o herramientas autenticadas donde no se requiere indexación SEO.
Importar componentes de React a Webflow con Code Components
Code Components permite crear componentes de React en un repositorio externo y lanzarlos directos al lienzo visual de Webflow. Así, diseñadores y especialistas en marketing pueden arrastrarlos y soltarlos en las páginas, configurar props y slots, y conectarlos con los datos del CMS de Webflow, ¡todo sin picar código! Esta joya se lanzó de forma oficial el 17 de septiembre de 2025 y está disponible en los planes de sitio CMS y Business, además de todos los planes de Workspace de pago.
Los Code Components admiten hooks, estado, efectos y contexto de React. Se ejecutan dentro de un límite de Shadow DOM, por lo que los estilos globales de Webflow no se aplican automáticamente en ellos. Los estilos responsivos deben incluirse dentro del propio CSS del componente.
Para configurar Code Components:
- Instala la CLI de Webflow y los paquetes de React en un proyecto local:
npm i --save-dev @webflow/webflow-cli @webflow/data-types @webflow/react. - Crea un archivo de configuración
webflow.jsonque especifique el nombre de la biblioteca, los patrones de archivo de los componentes y la configuración del paquete. - Crea componentes de React usando la convención de extensión de archivo
.webflow.tsx. - Ejecuta
npx webflow library sharepara publicar los componentes en el lienzo de Webflow. Esto requiere un token de API de Workspace y permisos de administrador de Workspace.
Una vez publicados, los Code Components aparecen en el panel de adición de Webflow. Sus capacidades clave incluyen:
- Propiedades y espacios configurables directamente en el lienzo por los diseñadores
- Conexión a campos del CMS de Webflow, localización y optimización de Webflow para pruebas A/B
- CI/CD mediante integración con GitHub con despliegues por rama
- Funcionalidad completa de React, incluyendo gestión de estado y obtención de datos de API
Estas capacidades hacen de los Code Components la forma más sencilla para que los diseñadores integren interfaces de React existentes en Webflow.
Code Components no tiene acceso a variables de entorno, así que todos los valores de configuración deben pasarse como props. Ni se te ocurra meter claves de API o secretos en el código del componente, ya que se ejecuta a la vista de todos en el navegador. Además, las API externas que usen estos componentes deben aceptar CORS desde el dominio alojado en Webflow.
Exporta diseños de Webflow a React con DevLink
La exportación de componentes de DevLink transforma los diseños de Webflow en código de React listo para producción, con CSS Modules, tokens de diseño e interacciones incluidos. Funciona justo al revés que Code Components: en vez de meter React en Webflow, saca los diseños de Webflow hacia tu entorno de React. La función de exportar componentes está actualmente en beta, y pide como mínimo Node.js v20.0.0 y React v16.18.0 para ponerse en marcha.
Este enfoque funciona para equipos que desean que los diseñadores iteren en Webflow mientras los desarrolladores consumen el resultado en un proyecto de Next.js, Gatsby o Remix. Solo los elementos convertidos en componentes de Webflow pueden exportarse; los elementos sin procesar no se incluyen en la sincronización.
Para configurar la exportación de componentes de DevLink:
- Instala la CLI de Webflow en un proyecto basado en React:
npm install -D @webflow/webflow-cli. - Ejecuta
webflow auth loginpara autenticarte a través del navegador y generar un archivo.envcon el ID del sitio y el token de API. - Crea una configuración
webflow.jsonen la raíz del proyecto especificando la URL del sitio, el directorio de salida y la configuración de CSS Modules. - En Webflow, selecciona elementos y crea componentes a partir de ellos. Solo los componentes son aptos para la exportación.
- Ejecuta
webflow devlink syncpara generar un directoriodevlink/que contenga componentes de React, módulos CSS, un archivo CSS global y un contenedorDevLinkProvider. - Añade el
DevLinkProvideral diseño raíz de la aplicación React e importa el archivo CSS global.
Después de realizar cambios de diseño en Webflow, vuelve a ejecutar webflow devlink sync para obtener las actualizaciones. Esta es una sincronización unidireccional: las actualizaciones de diseño deben originarse en Webflow y sincronizarse con la base de código de React.
Limitaciones clave a tener en cuenta:
- Los formularios requieren descomposición: exporta los componentes de entrada y botón por separado y ensámblalos con una biblioteca como
react-hook-form - . Los componentes de servidor de React en Next.js pueden necesitar la directiva
"use client"para componentes interactivos. El código personalizado a nivel de sitio y de página no se exporta, solo el código dentro de los elementos de incrustación de código (Code Embed) dentro de un componente.
Estas restricciones son importantes cuando planificas cuánta lógica debe residir en los componentes exportados frente a la aplicación que los rodea.
Para proyectos de Next.js, configura next.config.js para permitir imágenes alojadas en Webflow en la matriz images.remotePatterns. Las guías de configuración específicas del framework cubren Next.js, Gatsby y Remix.
Construye con las API de Webflow y React
Para la entrega de CMS headless, el procesamiento de formularios, las tiendas de comercio electrónico y la sincronización de datos en tiempo real, la ruta de integración de API proporciona un control programático total. Este enfoque requiere desarrollo del lado del servidor: un proxy de backend debe situarse entre el frontend de React y la API de Webflow, ya que los tokens de API no pueden exponerse en el código ejecutado por el navegador.
Las API disponibles incluyen:
- La Data API v2 de Webflow gestiona colecciones de CMS, elementos, productos, pedidos, formularios y la publicación de sitios.
- Los webhooks de Webflow activan eventos en tiempo real para cambios en el CMS, envíos de formularios y actividad de comercio electrónico.
- Los endpoints de páginas y código personalizado permiten actualizaciones de código personalizado a nivel de página y la recuperación del DOM de la página.
En conjunto, estas API cubren la capa de integración del lado del servidor que los componentes de React incrustados por sí solos no pueden proporcionar.
Todas las solicitudes utilizan autenticación mediante token Bearer. Los tokens de sitio se generan desde Configuración del sitio > Aplicaciones e integraciones > Acceso a API y se limitan a un solo sitio. Los tokens de espacio de trabajo admiten el acceso a múltiples sitios, mientras que los tokens de OAuth 2.0 se utilizan para aplicaciones de mercado e integraciones multiusuario con alcances granulares como cms:read, cms:write, ecommerce:read y sites:write.
Obtén contenido del CMS en un frontend de Next.js
El patrón de API más común utiliza Webflow como un CMS headless con un frontend de React en Next.js. Los editores de contenido trabajan en el CMS visual de Webflow mientras la aplicación Next.js consume JSON desde endpoints REST.
Para implementar la entrega de CMS headless:
- Almacena el token de API de Webflow y el ID de la colección en
.env.local— nunca en el código del lado del cliente. - Obtén elementos del CMS desde
GET /v2/collections/{collection_id}/items/liveen un componente de servidor de Next.js. El endpoint/items/livedevuelve solo contenido publicado, evitando elementos en borrador en el frontend público. - Utiliza ISR de Next.js con
next: { revalidate: 3600 }para almacenar respuestas en caché y mantenerte dentro de los límites de solicitudes de API. Las solicitudes almacenadas en caché en la CDN no tienen límites de tasa efectivos; solo las solicitudes de origen no almacenadas en caché cuentan para los límites del plan.
// app/blog/page.tsx
export default async function BlogPage() {
const res = await fetch(
`https://api.webflow.com/v2/collections/${process.env.WEBFLOW_COLLECTION_ID}/items/live`,
{
headers: {
Authorization: `Bearer ${process.env.WEBFLOW_API_TOKEN}`,
Accept: 'application/json',
},
next: { revalidate: 3600 },
}
);
const { items } = await res.json();
return (
<ul>
{items
.filter(item => !item.isDraft && !item.isArchived)
.map(item => <li key={item.id}>{item.fieldData.name}</li>)}
</ul>
);
}
Para colecciones con más de 100 elementos, utiliza la paginación con los parámetros de consulta offset y limit: la API devuelve un máximo de 100 registros por solicitud.
Sincroniza contenido en tiempo real con webhooks
Los webhooks permiten revalidar la caché bajo demanda cuando cambia el contenido del CMS, eliminando la necesidad de intervalos de revalidación fijos.
Para configurar la sincronización mediante webhooks:
- Registra un webhook mediante
POST /v2/sites/{site_id}/webhookscon untriggerTypedecollection_item_changedocollection_item_published. - Crea un manejador de rutas de API en Next.js que reciba la carga útil del webhook, lea los campos
triggerTypeyslug, y llame arevalidatePath()orevalidateTag()para invalidar la página en caché. - Para los webhooks creados mediante aplicaciones OAuth, verifica la cabecera HMAC-SHA256
x-webflow-signatureantes de procesarlos. Los webhooks creados a través del panel de control o mediante tokens de sitio no incluyen cabeceras de firma.
import { revalidateTag } from 'next/cache';
export async function POST(req) {
const payload = await req.json();
if (['collection_item_changed', 'collection_item_published'].includes(payload.triggerType)) {
revalidateTag('webflow-cms');
}
return new Response('OK', { status: 200 });
}
Los tipos de eventos de webhook confirmados incluyen collection_item_created, collection_item_changed, collection_item_deleted, collection_item_published, form_submission, ecomm_new_order, ecomm_order_changed, y ecomm_inventory_changed. Se pueden registrar hasta 75 webhooks por tipo de activador en cada sitio. Esto convierte a los webhooks en una forma práctica de mantener los frontends de React sincronizados con el contenido gestionado en Webflow.
¿Qué puedes construir con la integración de React en Webflow?
Integrar React con Webflow te permite añadir interfaces dinámicas y basadas en datos a sitios diseñados visualmente, sin tener que reconstruir todo el frontend desde cero.
- Calculadoras de ROI y precios: Crea calculadoras con lógica condicional compleja, cálculos en tiempo real y validación de entradas que actualicen los resultados a medida que los usuarios ajustan controles deslizantes y menús desplegables. Publícalas como un componente de código (Code Component) para que el equipo de marketing pueda colocarlo en cualquier página de destino y configurar las etiquetas desde el lienzo de Webflow.
- Blog o centro de contenido headless: Utiliza el CMS de Webflow como backend de contenido, mientras un frontend de Next.js se encarga del renderizado del lado del servidor, diseños personalizados y filtrado avanzado. Los editores de contenido publican desde la interfaz visual de Webflow. La aplicación React consume los elementos a través de la API de datos con caché ISR.
- Formularios de calificación de leads de varios pasos: Crea formularios con lógica de ramificación, validación de campos en tiempo real y enrutamiento a CRM que vayan más allá de los formularios nativos de un solo paso de Webflow. Monta el formulario de React dentro de un elemento de inserción de código (Code Embed) o entrégalo como un componente de código con propiedades configurables para diferentes páginas de destino.
- Configuradores de productos y herramientas de reserva: Construye selectores interactivos de opciones de productos, generadores de vistas previas en vivo o interfaces de programación basadas en calendarios. React gestiona el estado y el renderizado condicional, mientras que Webflow proporciona el diseño de la página, el contenido del CMS y la infraestructura de alojamiento.
Estos ejemplos muestran cómo la integración puede dar soporte tanto a widgets incrustados como a patrones de frontend headless más amplios.
Si necesitas un mayor control sobre la entrega de datos en tiempo real, la autenticación de usuarios o la gestión de pedidos de comercio electrónico, la ruta de integración mediante API cubre esos casos con total flexibilidad.
Preguntas frecuentes
Pues no. El motor de renderizado de Webflow no funciona sobre React, y no basta con soltar un componente de React en la página sin cargarlo y montarlo como es debido. Webflow ofrece tres caminos oficiales para entenderse con React: DevLink para sincronizar componentes entre ambos mundos, Code Embeds para incrustar React mediante etiquetas de script o CDN, y las API de Webflow para integraciones a medida con su API REST. La página de integración de React en Webflow te cuenta todos los detalles de cada opción.
¡Viajan en sentidos opuestos! Code Components importa componentes de React desde un repositorio externo hacia el lienzo visual de Webflow, listos para que el equipo de diseño los arrastre, los suelte y ajuste sus props sin tocar código. En cambio, la exportación de DevLink convierte componentes diseñados en Webflow en código de React para proyectos de Next.js, Gatsby o Remix. Code Components ya está disponible para todo el mundo desde septiembre de 2025, mientras que la exportación de componentes sigue en fase beta.
El contenido que React renderiza a través de código incrustado no aparece en el HTML inicial que devuelve el servidor, lo que puede jugar malas pasadas al SEO si los motores de búsqueda necesitan rastrearlo. De hecho, las herramientas nativas de SEO de Webflow están completamente a ciegas ante lo que muestra React. Si te juegas el posicionamiento orgánico, apuesta por el CMS nativo y los bloques de página de Webflow, o monta un frontend en Next.js con Webflow Cloud, donde el renderizado del lado del servidor genera un HTML impecable para los rastreadores.
Sí, a través de dos vías. Los componentes de código pueden conectarse directamente a los campos del CMS de Webflow en el lienzo: los diseñadores vinculan los datos del CMS a las propiedades del componente de forma visual. Para configuraciones headless, una aplicación de React o Next.js puede obtener elementos del CMS a través de la API de datos de Webflow utilizando
GET /v2/collections/{collection_id}/items/live. Las solicitudes a la API requieren un proxy de backend para mantener los tokens de autenticación fuera del código ejecutado en el navegador.La manipulación del DOM virtual de React puede entrar en conflicto con el sistema de animaciones de Webflow (IX2), que se vincula al DOM estático al cargar la página. Una vez que un componente de React se monta y modifica la estructura del DOM, las animaciones activadas por scroll o clics pueden dejar de funcionar en los nodos afectados. La solución documentada es llamar a
window.Webflow?.require('ix2').init()una vez después de que el componente de React se monte. Para los componentes de código que se ejecutan en un Shadow DOM, el sistema de animaciones de Webflow no interfiere; las animaciones CSS estándar y@keyframesdentro del componente funcionan como se espera.

Descripción
Añade componentes de React a sitios de Webflow mediante elementos Code Embed, Code Components o DevLink. Utiliza la API de datos de Webflow para potenciar frontends de React con contenido del CMS.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.

Typed.js
Conecta Typed.js, una biblioteca de animación de escritura en JavaScript, con Webflow para añadir titulares animados que rotan mediante elementos de inserción de código y cadenas gestionadas por el CMS.

Typed.js
Añade Typed.js a Webflow con código personalizado para escribir y repetir el texto de un titular principal, o utiliza palabras rotativas desde campos del CMS.
Sweet Text de Finsweet
Scrollbar Styler de Finsweet
Dale estilo a las barras de desplazamiento de Webflow visualmente con el generador de CSS gratuito de Finsweet, pega el código en tu sitio y añade las propiedades estándar para una compatibilidad total con navegadores.
POWR
Añade formularios, ventanas emergentes, temporizadores de cuenta atrás y chat en vivo de POWR a un sitio de Webflow mediante un elemento Code Embed o código en el pie de página, y envía las respuestas de los formularios al CMS a través de Zapier.
One2 Menu
Pega un fragmento de One2 Menu en Webflow y el menú de tu restaurante se mantendrá actualizado desde el panel de control de One2.
MathJax
Conecta MathJax, un motor de visualización matemática de código abierto, con Webflow para renderizar ecuaciones LaTeX como fórmulas tipográficas con accesibilidad integrada, compatibilidad con lectores de pantalla y consistencia entre navegadores.

Listen Notes
Conecta Listen Notes, un motor de búsqueda y API de podcasts, con Webflow para insertar reproductores de episodios, añadir búsquedas de podcasts y completar colecciones del CMS con metadatos de más de 3,7 millones de podcasts.
Isótopo
Conecta Isotope, una biblioteca de diseño JavaScript de Metafizzy, con Webflow para crear cuadrículas masonry animadas con filtrado, ordenación y transiciones CSS del lado del cliente en las Listas de colección del CMS.


