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 → Image: Optimize

AI-generated

Overview

This node operation optimizes images using Cloudinary's transformation capabilities. It allows users to specify an image asset by its public ID and apply optimization transformations such as adjusting image quality automatically or with specific presets. This is useful for scenarios where you want to reduce image file size for faster web delivery without manually editing images, such as optimizing product photos for an e-commerce site or resizing images for responsive web design.

Use Case Examples

  1. Optimize an uploaded image by specifying its public ID and setting the quality to 'auto' for best balance between quality and file size.
  2. Chain multiple transformations by continuing from a previous transformation string to compound effects in a single delivery URL.

Properties

Name Meaning
Public ID The public identifier of the image asset in Cloudinary, including any folder path but excluding the file extension. This is required to specify which image to optimize.
Type The Cloudinary delivery type, which determines the URL path segment for the asset. Usually set to 'Upload' for public assets. Other types like 'Private' or social media sources require signed URLs which are not generated by this node.
Continue From Transformation Optional transformation string to prepend before the current operation's transformation, allowing chaining of multiple transformations into one delivery URL.
Quality Automatic image quality level for optimization, with options ranging from 'auto' (recommended) to 'low' for smallest file size and lowest quality.
Additional Options Optional additional transformation options such as asset version to bust CDN caches.

Output

JSON

  • transformation - The resulting Cloudinary transformation string that can be used to build the delivery URL for the optimized image.

Dependencies

  • Cloudinary API credentials including cloud name, API key, and API secret

Troubleshooting

  • If the node throws an error about unsupported operation, verify that the resource is 'Transform' and operation is 'Image: Optimize'.
  • If delivery URLs fail to load for 'Private' or 'Authenticated' types, note that signed URLs are required but not generated by this node; use 'Upload' type unless signed URLs are handled externally.
  • Ensure the public ID is correctly specified without file extension and includes any folder path if applicable.

Links

Discussion