Cloudinary
Conecta Cloudinary, una plataforma de API de imágenes y vídeo, con Webflow para distribuir contenido multimedia transformado mediante parámetros de URL, incrustar widgets de carga y galerías, y automatizar la carga del CMS a partir de archivos procesados.
Las bibliotecas multimedia grandes alcanzan rápidamente el límite de carga de 4 MB, y las fotos de productos, portafolios y vídeos de alta resolución suelen requerir redimensionamiento o conversión de formato manual antes de llegar a tu sitio. Conectar Cloudinary elimina todo ese trabajo previo.
Las imágenes y los vídeos viven a sus anchas en la CDN de Cloudinary, donde un par de parámetros en la URL cambian formato, calidad, tamaño y recortes en un abrir y cerrar de ojos. Webflow CMS guarda enlaces en vez de archivos pesados, dejando atrás el molesto límite de 4 MB para tus archivos originales; así, cada visitante recibe WebP, AVIF o JPEG a la medida exacta de su navegador y pantalla. Ideal para darle vidilla a catálogos de ecommerce, webs de agencias, publicaciones y portafolios de fotografía.
Cómo integrar Cloudinary con Webflow
¿Qué es Cloudinary? Cloudinary es una plataforma de APIs de imagen y vídeo pensada para subir, transformar, comprimir y servir contenidos multimedia como la seda. Te ofrece transformaciones mágicas vía URL, prácticos widgets para subidas o galerías y una CDN global que entrega cada archivo listo para cualquier dispositivo. Cuenta con SDKs para Node.js, Python, PHP, JavaScript, React y más de 14 entornos adicionales.
Recurre a Cloudinary cuando el volumen de archivos multimedia, su tamaño o los requisitos de rendimiento de un sitio superen lo que permite la gestión nativa de archivos. Los catálogos de productos extensos y los portafolios de fotografía con originales de alta resolución son casos comunes. Las páginas de marketing con mucho vídeo también se benefician del procesamiento al instante y la distribución mediante CDN de Cloudinary.

Existen tres métodos generales de conexión, que la mayoría de los equipos dividen en cuatro patrones de implementación prácticos:
- Las transformaciones por URL de Cloudinary te permiten pegar enlaces de imágenes y vídeos ya optimizados directamente en campos de CMS o elementos nativos, ¡sin tocar una sola línea de código!
- Los widgets de Cloudinary mediante elementos Code Embed llenan tus páginas de acción con zonas de subida de arrastrar y soltar, galerías de productos y reproductores de vídeo listos para rodar.
- Los flujos de automatización con Zapier crean elementos en el CMS de forma automática en cuanto subes o etiquetas nuevos archivos en Cloudinary.
- La Data API y la API de Cloudinary te dan el control total de tus pipelines multimedia, publicaciones mediante webhooks y actualizaciones masivas en el CMS, aunque requieren ponerse manos a la obra con código en el servidor.
La mayoría de las implementaciones combinan dos o más de estos métodos según la complejidad de la configuración.
Incrusta archivos de Cloudinary con transformaciones de URL
Cloudinary distribuye cada archivo a través de una URL que acepta parámetros de transformación integrados. Puedes pegar estas URL directamente en elementos de imagen, elementos de vídeo o campos de texto e imagen del CMS sin necesidad de JavaScript ni código personalizado. Este método funciona en todos los planes, incluidos los espacios de trabajo Starter gratuitos.
Utiliza esta estructura de URL de distribución de Cloudinary:
https://res.cloudinary.com/[cloud-name]/image/upload/[transformations]/[public-id].[format]
Añade parámetros entre /upload/ y el ID público para controlar el resultado. Estos son los que más utilizarás:
f_autoselecciona el mejor formato según el navegador (WebP, AVIF, JPEG)q_autoajusta la calidad automáticamente para reducir el tamaño del archivow_800,h_600,c_fillredimensiona y recorta a las dimensiones exactasdpr_autosirve archivos de mayor resolución para pantallas Retina
Estos parámetros cubren las necesidades habituales de redimensionamiento de imágenes para distintos tamaños de pantalla y pueden combinarse en una única URL de entrega.
Para configurar la entrega basada en URL:
- Sube tu imagen a la consola de Cloudinary en Media Library > Upload.
- Crea una URL de entrega con los parámetros de transformación que desees. Por ejemplo:
https://res.cloudinary.com/mycompany/image/upload/f_auto,q_auto,w_800,c_fill/my-hero-image.jpg - Pega la URL en una pestaña del navegador para confirmar que la imagen transformada se carga correctamente.
- Abre la colección del CMS y pega la URL en un campo de texto o de imagen del elemento correspondiente.
- En la plantilla de la página de la colección, vincula ese campo al origen de un elemento de imagen.
- Publica el sitio y verifica que la imagen se renderice desde la CDN de Cloudinary.
Este enfoque requiere crear las URL manualmente para cada activo. Para flujos de trabajo que completan campos del CMS sin necesidad de copiar y pegar manualmente, los métodos de Zapier y API que aparecen a continuación cubren esos casos.
Añade widgets de Cloudinary con elementos de inserción de código (Code Embed)
Cloudinary incluye prácticos widgets en JavaScript para el navegador que dotan a tus páginas de subida de archivos, galerías y reproducción de vídeo al instante. Lo habitual es cargar el script en el código personalizado de las etiquetas head y body y activarlo con un elemento Code Embed en la página. Para vídeos sencillos, Cloudinary también cuenta con un iframe para pegar directamente en un Code Embed sin complicarte con scripts adicionales.
La disponibilidad de código personalizado depende de los derechos de tu espacio de trabajo o plan de sitio. Si tu espacio de trabajo está en el nivel gratuito Starter y no tienes un plan de sitio activo, no podrás añadir elementos de inserción de código ni inyectar scripts. Actualiza a Core o superior, o utiliza un plan de sitio activo, para usar las funciones de código personalizado.
Añade el widget de carga (Upload Widget)
Tanto los visitantes como el equipo editorial pueden usar el Upload Widget para enviar archivos a Cloudinary con solo arrastrar y soltar. Admite subidas desde dispositivos locales, cámaras, Google Drive, Dropbox, Instagram, Unsplash e iStock. Olvídate del código en el servidor: todo funciona de maravilla con un preset de subida sin firma.
Para añadir el widget de carga:
- Ve a Site Settings > Custom Code > Head Code y pega el script del widget:```html
2. In the Cloudinary Console, go to Settings > Upload > Upload presets > Add upload preset. Set the Signing Mode to Unsigned and save the preset name.
3. Add a Code Embed element to the page where you want the upload button. Paste this initialization code:```html
<button id="upload_widget" onclick="openWidget()">Upload Image</button>
<script type="text/javascript">
function openWidget() {
cloudinary.openUploadWidget({
cloudName: 'YOUR_CLOUD_NAME',
uploadPreset: 'YOUR_UNSIGNED_PRESET_NAME',
sources: ['local', 'url', 'camera', 'google_drive', 'dropbox'],
multiple: false
}, function(error, result) {
if (!error && result && result.event === "success") {
console.log('Uploaded URL: ', result.info.secure_url);
}
});
}
</script>
- Publica el sitio y prueba el widget en la URL en vivo. El widget no se ejecutará dentro de la vista previa del lienzo.
Reemplaza YOUR_CLOUD_NAME y YOUR_UNSIGNED_PRESET_NAME con los valores de tu panel de control de Cloudinary y los ajustes preestablecidos de carga. El secure_url devuelto en la devolución de llamada contiene la URL de entrega de la CDN para el activo subido.
Añade el widget de galería de productos (Product Gallery Widget)
El Product Gallery Widget luce imágenes, vídeos, vistas en 360 grados y modelos 3D en un visor personalizable y lleno de estilo. Es el compañero perfecto para fichas de producto o páginas de detalle donde apetece explorar cada elemento desde todos los ángulos.
Para añadir la Galería de productos:
- Ve a Site Settings > Custom Code > Head Code y añade el script de la galería:```html
2. Add a Div Block to the page and assign it the ID `my-gallery` in the element settings panel.
3. Below the Div Block, add a Code Embed element with the initialization code:```javascript
const myGallery = cloudinary.galleryWidget({
container: "#my-gallery",
cloudName: "your-cloud-name",
mediaAssets: [{ tag: "your-tag" }]
});
myGallery.render();
- Publica y prueba en el sitio en vivo.
La matriz mediaAssets acepta etiquetas, IDs públicos o una combinación de ambos. Configura mediaType: "video" en un objeto de recurso para incluir vídeo junto a las imágenes. Cloudinary también ofrece un configurador de Galería de productos donde puedes ajustar las opciones visualmente, hacer clic en Copiar al portapapeles y pegar el código generado directamente en un elemento de inserción de código (Code Embed).
Insertar el reproductor de vídeo
El Video Player de Cloudinary adapta la tasa de bits al vuelo, escoge la mejor calidad por su cuenta y te deja personalizar los controles. Tienes dos formas geniales de ponerlo a rodar.
Reproductor basado en script: Carga el CSS y JS del reproductor en el código de cabecera (head code) de tu sitio, luego añade una etiqueta <video> mediante un elemento de inserción de código:
<video id="my-player" class="cld-video-player cld-fluid" data-cld-public-id="your-public-id"></video>
La clase cld-fluid hace que el reproductor se ajuste al ancho de su contenedor.
Inserción mediante iframe (sin scripts): Inicia sesión en la consola de Cloudinary, abre la Biblioteca multimedia, haz clic derecho en tu recurso de vídeo y selecciona Insertar (Embed). Elige el formato iframe, copia el código y pégalo en un elemento de inserción de código. Este método no requiere cargar scripts adicionales y funciona de maravilla si buscas la configuración más sencilla.
Si utilizas tanto el reproductor de vídeo como el widget de carga en la misma página, carga primero los scripts del reproductor de vídeo en el código de cabecera para evitar conflictos de inicialización. Puedes añadir cargas, galerías y reproducción de vídeo sin necesidad de crear un backend personalizado.
Conecta con Zapier
Zapier cuenta con dos plantillas listas para sacarle chispas a este dúo:
- «Crear elementos de Webflow a partir de nuevos recursos etiquetados en Cloudinary» entra en acción al añadir una etiqueta específica en Cloudinary y genera al instante su correspondiente elemento en el CMS.
- «Crear nuevos elementos de Webflow a partir de recursos recién subidos a Cloudinary» se activa con cada nueva subida y traslada la información del archivo a los campos del CMS.
Para configurar una de estas plantillas de Zapier:
- Crea una cuenta en Zapier y conecta tu cuenta de Cloudinary mediante OAuth.
- Conecta tu cuenta de Webflow mediante OAuth.
- Elige una de las dos plantillas prediseñadas en la página de integración de Cloudinary + Webflow.
- Asigna los campos de Cloudinary a los campos de tu colección de CMS de destino.
- Activa el Zap y realiza una prueba con una carga de muestra.
Los planes gratuitos de Zapier comprueban si hay nuevas cargas cada 15 minutos. Para una sincronización instantánea, necesitas un plan de pago de Zapier con activadores de webhook.
Desarrolla con la API de datos y la API de Cloudinary
La integración mediante API te da control total sobre cómo fluye el contenido multimedia entre Cloudinary y tu sitio. Este enfoque requiere un servidor backend o funciones serverless para gestionar la autenticación, el procesamiento de webhooks y la transformación de datos. Es ideal para desarrolladores de agencias que crean flujos de trabajo multimedia para clientes y para equipos con procesos de publicación personalizados.
Utiliza estas API:
- La API de subida de Cloudinary se encarga de recibir archivos, aplicar transformaciones sobre la marcha y eliminar contenido
- La API de administración de Cloudinary gestiona carpetas, etiquetas, metadatos y listados de recursos
- La Data API coordina las colecciones del CMS y la gestión de archivos
- Los webhooks lanzan eventos en tiempo real cada vez que creas, modificas o publicas elementos en el CMS
En conjunto, estas API cubren la carga de archivos, la gestión de metadatos, las actualizaciones del CMS y los flujos de publicación basados en eventos.
Las llamadas a la API de Cloudinary autenticadas desde el lado del servidor suelen utilizar autenticación básica HTTP con tu clave y secreto de API. Los flujos de carga seguros para el navegador pueden usar ajustes preestablecidos de carga sin firma, mientras que los flujos firmados utilizan parámetros generados en tu backend. Las llamadas a la API de datos utilizan autenticación mediante token Bearer con alcances OAuth. Nunca expongas el secreto de la API de Cloudinary ni tu token Bearer de la API de datos en el código del lado del cliente.
Almacena imágenes procesadas en el CMS de Webflow
En el flujo de trabajo de API más común, subes los archivos a Cloudinary, construyes las URL de transformación y escribes esas URL en los campos de los elementos del CMS.
Para implementarlo:
- Sube una imagen a Cloudinary a través de la API de carga:```bash curl -X POST https://api.cloudinary.com/v11/{cloudname}/image/upload
-F "file=@photo.jpg"
-F "uploadpreset=webflowcms"
The response includespublicidandsecureurl. 2. Construct a transformation URL by inserting parameters between/upload/and the public ID:https://res.cloudinary.com/{cloudname}/image/upload/qauto,fauto,w1200/leatherbaggray.jpg
3. Write the URL to a CMS item using the Data API:```bash
curl -X PATCH \
https://api.webflow.com/v2/collections/{collection_id}/items/{item_id} \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"fieldData": {"hero-image-url": "https://res.cloudinary.com/demo/image/upload/q_auto,f_auto,w_1200/leather_bag_gray.jpg"}}'
Este patrón mantiene los originales de alta resolución en Cloudinary y almacena solo cadenas de URL ligeras en el CMS.
Automatiza la publicación tras el procesamiento de imágenes
Para sitios que necesitan que el contenido multimedia procesado se publique sin intervención manual, combina las transformaciones inmediatas de Cloudinary con notificaciones de webhook y el endpoint de publicación.
Para implementarlo:
- Sube a Cloudinary con una transformación inmediata y una URL de notificación:```bash
curl -X POST https://api.cloudinary.com/v11/{cloudname}/image/upload
-F "file=@/path/to/image.jpg"
-F "uploadpreset=webflowcms"
-F "eager=w800,h600,cfill,qauto,fauto"-F "notificationurl=https://your-backend.com/cloudinary-webhook" - Tu backend recibe un POST de webhook desde Cloudinary cuando se completa la transformación inmediata. La carga útil incluye la
secure_urldel archivo procesado. - Tu backend escribe la URL en un elemento del CMS a través de
PATCH /v2/collections/{collection_id}/items/{item_id}. - Tu backend publica el elemento a través de
POST /v2/collections/{collection_id}/items/publishcon el ID del elemento en el cuerpo de la solicitud. Este endpoint devuelve202 Acceptedy se procesa de forma asíncrona.
También puedes registrar un webhook para collection_item_changed eventos con el fin de activar el procesamiento de Cloudinary en la dirección opuesta. Cuando un editor actualiza un elemento del CMS, tu backend recibe el evento y llama a la API explícita de Cloudinary para generar nuevos derivados, como imágenes para Open Graph. Utiliza este enfoque cuando tu flujo de publicación dependa de la lógica del backend y la coordinación mediante webhooks.
¿Qué puedes construir con la integración de Cloudinary en Webflow?
Integrar Cloudinary te permite ofrecer contenido multimedia adaptado al dispositivo y al formato en todo tu sitio, sin necesidad de exportar imágenes ni convertir formatos manualmente.
Catálogos de productos con procesamiento automático: Almacena una única imagen de alta resolución por SKU en Cloudinary y utiliza parámetros de URL como para generar miniaturas, vistas detalladas y recortes para móviles bajo demanda. Los elementos del CMS solo contienen las cadenas de URL. Cada plantilla de página de producto muestra entonces imágenes adaptadas al formato y al dispositivo desde la CDN de Cloudinary.f_auto,q_auto,w_800,c_fill
- Galerías para portafolios de fotografía: Sube imágenes a toda resolución en Cloudinary sin tropezar con el tope de 4 MB. Juega con las transformaciones por URL para servir versiones ligeras y perfectas para cada pantalla a partir de un solo archivo maestro. Una Collection List conectada a elementos del CMS con enlaces de Cloudinary llenará tu galería de vida al instante.
- Portales con contenido enviado por la comunidad: Integra el Upload Widget en una página para que tu público o colaboradores suban archivos directos a Cloudinary. Una plantilla de Zapier o un webhook creará un borrador en el CMS con el enlace correspondiente, listo para que el equipo de moderación le dé el visto bueno y lo publique con un clic.
- Páginas de marketing repletas de vídeo: Sube tus vídeos a Cloudinary con transcodificación adaptativa de bitrate e incrusta el Cloudinary Video Player en tus landing pages. Cloudinary se encarga de la transmisión HLS, el cambio de calidad al vuelo y la generación de miniaturas. Los campos del CMS guardan el ID público del vídeo y la URL de la miniatura para cada página.
Si necesitas un mayor control sobre los flujos de publicación basados en webhooks o actualizaciones masivas del CMS en bibliotecas multimedia extensas, utiliza la ruta de integración mediante API.
Preguntas frecuentes
Pues no. No hay ninguna app instalable de Cloudinary en el Marketplace de Apps de Webflow. Hay tres formas de conectarlo: incrustar URLs de Cloudinary en campos del CMS, recurrir a herramientas de automatización o crear integraciones con las APIs de ambos. Todas requieren una configuración manual en vez de instalarse con un simple clic.
La mayoría de los widgets de Cloudinary en Webflow usan un elemento Code Embed o código personalizado, así que todo depende de tu espacio de trabajo o del plan que tengas activo en Webflow. Si solo buscas servir imágenes mediante URLs sin complicarte con JavaScript, puedes pegar los enlaces de entrega de Cloudinary directamente en elementos Image nativos desde cualquier plan de Webflow, ¡hasta en el gratuito! Échale un ojo a la documentación sobre código personalizado de Webflow para consultar los requisitos actuales de cada plan.
Sí. Zapier ofrece dos plantillas preconfiguradas que se activan con nuevas subidas a Cloudinary o recursos etiquetados recientemente, creando elementos en el CMS de Webflow con la URL del archivo asignada a un campo de colección. Los planes gratuitos de Zapier comprueban si hay nuevas subidas cada 15 minutos. La sincronización instantánea requiere un plan de pago de Zapier con activadores de webhook.
¡Totalmente! Sube tus imágenes y vídeos originales directamente a Cloudinary y guarda solo la URL de entrega resultante en un campo de texto o URL del CMS de Webflow. Como Webflow ni se entera de que el archivo original existe, el límite de 4 MB para archivos del CMS no afecta a esos contenidos. De hecho, es la arquitectura estrella recomendada para cualquier proyecto con contenido multimedia en alta resolución.
No. El método de imagen basado en JavaScript (usando la biblioteca con ) impide que el navegador precargue las imágenes antes de que se ejecute el script. Esto retrasa el Largest Contentful Paint para el contenido visible al cargar la página. Usa URLs estáticas de Cloudinary con parámetros de ancho explícitos (como ) para las imágenes principales. Reserva el método de JavaScript para cuadrículas de imágenes, galerías y secciones inferiores. El blog de Webflow sobre imágenes responsivas de Cloudinary documenta este compromiso en detalle.
cloudinary-corew_auto,c_scalew_1200,f_auto,q_auto
Descripción
Cloudinary añade a Webflow transformaciones de imágenes y vídeo basadas en URL, distribución mediante CDN y widgets multimedia. Pega las URL de transformación en los campos del CMS, incrusta widgets de carga o galerías mediante elementos de código (Code Embed), o utiliza la API de Cloudinary para flujos de trabajo de publicación automatizados.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.

Goat Slider
Conecta Goat Slider, una aplicación de slider basada en CMS, con Webflow para añadir carruseles y sliders dinámicos que se actualizan automáticamente cuando cambia tu contenido.

Iconos y personajes 3D editables de Pixcap
Conecta Pixcap, una biblioteca de recursos 3D personalizables, con Webflow para explorar, personalizar e insertar iconos, ilustraciones y personajes 3D directamente en Webflow sin necesidad de conocimientos de modelado 3D.

CutCopy
Conecta CutCopy con Webflow para mover colecciones de variables y atributos de elementos entre proyectos en lugar de tener que reconstruirlos a mano.

Optimizador de imágenes CMS de Devblocks
Conecta el optimizador de imágenes CMS de Devblocks con Webflow para convertir por lotes tus imágenes existentes del CMS a WebP sin tener que volver a subir ni un solo archivo.

Flowdrive
Conecta Flowdrive con Webflow para alojar archivos y vídeos, insértalos desde el Designer y añade campos de carga de archivos a tus formularios.

Lummi
Conecta Lummi, una biblioteca de recursos visuales con IA, con Webflow para buscar e insertar imágenes de uso comercial directamente en el lienzo.
Gestión de imágenes
Convierte las imágenes de las colecciones del CMS de Webflow a WebP o AVIF directamente en Webflow con la aplicación Image Management, o automatiza el proceso con la API de Assets.
Smootify Icons
Conecta Smootify Icons con Webflow para colocar iconos SVG de ocho bibliotecas directamente en el lienzo, con estilos personalizados y sin necesidad de subidas ni código.
Clip Path Bae
Conecta Clip Path Bae con Webflow para recortar imágenes, divs y otros elementos en formas poligonales, circulares, elípticas o SVG personalizadas sin escribir código.


