Cloudinary Integration
The Cloudinary integration package enables seamless media asset management and delivery through Cloudinary's cloud-based platform. Upload images, videos, and other media files directly to your Cloudinary account with automatic optimization, transformation, and CDN delivery.
Overview
Cloudinary is a leading cloud-based media management platform that provides comprehensive solutions for storing, optimizing, and delivering images and videos. This integration package allows you to programmatically upload media files from your e-commerce platform, PIM, or other systems to Cloudinary's infrastructure.
Key Features
☁️ Cloud Storage
Upload and store unlimited media assets in Cloudinary's secure, scalable cloud infrastructure.
🖼️ Automatic Optimization
Images are automatically optimized for web delivery with intelligent compression and format selection.
🌐 CDN Delivery
Global CDN distribution ensures fast media delivery to users worldwide.
🔄 Batch Processing
Upload multiple files in a single workflow with configurable delays between uploads.
⚙️ Upload Options
Configure folder structure, public IDs, tags, and transformations during upload.
🎯 Workflow Ready
Seamlessly integrate Cloudinary uploads into multi-step workflows for automated media management.
Authentication Setup
To use the Cloudinary integration, you'll need credentials from your Cloudinary account:
Access Cloudinary Dashboard
Log in to your Cloudinary Console and navigate to the Dashboard.
Get Account Credentials
Find your Cloud Name, API Key, and API Secret in the Account Details section of your dashboard.
Configure Integration
Add your Cloudinary credentials to the integration configuration in Retrieve.
Configuration
Configure the Cloudinary integration with your account credentials:
{
"cloudinary": {
"cloud_name": "your-cloud-name",
"api_key": "your-api-key",
"api_secret": "your-api-secret",
"chunk_waiting_time": 500
}
}Configuration Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
cloud_name | string | Yes | Your Cloudinary cloud name (found in dashboard) |
api_key | string | Yes | Your Cloudinary API key |
api_secret | string | Yes | Your Cloudinary API secret |
chunk_waiting_time | number | No | Milliseconds to wait between batch uploads (default: 500) |
Use Cases
🛍️ Product Image Management
Upload product images from PIM or e-commerce platforms to Cloudinary for optimized web delivery.
📦 PIM Media Sync
Sync media assets from PIM systems like InRiver to Cloudinary for centralized media management.
🔄 Multi-Platform Distribution
Upload media once to Cloudinary and distribute optimized versions across multiple sales channels.
📸 User-Generated Content
Process and upload user-submitted images or reviews to Cloudinary for moderation and display.
Best Practices
Use Folder Organization
Organize uploaded files into logical folders using the folder option (e.g., products/category/sku) for better asset management.
Implement Rate Limiting
Use chunk_waiting_time to control upload speed and avoid hitting Cloudinary API rate limits, especially for large batches.
Tag Your Assets
Add meaningful tags during upload to enable easy searching and filtering in the Cloudinary console.
Store Public IDs
Save the returned public_id from upload responses to reference and transform images later without re-uploading.