Cloudinary icon

Cloudinary

Upload images and videos, build optimized transformation and delivery URLs, generate video players, and manage, search, tag, and edit metadata in your Cloudinary media library

Actions23

Transform → Compose: Combine Transformations

AI-generated

Overview

This node operation, 'Compose: Combine Transformations', is designed to build a combined transformation URL for Cloudinary assets, such as images or videos. It allows users to specify a sequence of transformation steps (like resizing, cropping, optimizing, converting formats, trimming videos, or applying raw transformation components) that are applied in order to a given asset identified by its public ID. This is useful for dynamically generating URLs that deliver media with specific transformations applied, enabling optimized and customized media delivery in web or app projects.

Use Case Examples

  1. Combining multiple image transformations such as resizing, cropping, and format conversion into a single URL for efficient delivery.
  2. Creating a video URL with trimming and thumbnail extraction steps combined.
  3. Applying a sequence of optimizations and resizing steps to an image asset to improve loading times and visual quality.

Properties

Name Meaning
Public ID The public identifier of the Cloudinary asset, including any folder path but excluding the file extension. This identifies the specific media asset to transform.
Type The Cloudinary delivery type, which determines the URL path segment. Commonly 'upload' for public assets. Other types like 'private' or social media sources require signed URLs which are not generated by this node.
Resource Type Specifies whether the asset is an image or video, affecting the URL path and transformation behavior.
Steps A collection of transformation steps applied in order. Each step corresponds to a Cloudinary transformation component such as convert format, crop, optimize, raw component, resize, or trim video. Steps can be reordered and configured with specific parameters like dimensions, aspect ratio, quality, and more.
Additional Options Optional additional parameters such as asset version to bust CDN caches.

Output

JSON

  • url - The generated Cloudinary URL with the combined transformations applied.

Dependencies

  • Cloudinary API credentials including cloud name, API key, and API secret are required for authentication.

Troubleshooting

  • Ensure the public ID is correct and does not include the file extension.
  • Use 'upload' type for public assets unless signed URLs are handled externally, as private or authenticated types require signed URLs which this node does not generate.
  • Verify transformation steps are valid and supported by Cloudinary to avoid errors.
  • If the node throws 'Unsupported operation' error, check that the resource and operation names are correctly set.

Links

Discussion