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: Convert Format

AI-generated

Overview

This node operation converts an image from its original format to a specified target format using Cloudinary's transformation capabilities. It is useful for scenarios where you need to standardize image formats, optimize images for web delivery, or prepare images for specific use cases such as webp for better compression or avif for modern browsers. For example, converting a JPEG image to WebP format to reduce file size and improve loading times on websites.

Use Case Examples

  1. Convert a JPEG image to WebP format for optimized web delivery.
  2. Change PNG images to AVIF format for better compression and quality.
  3. Batch convert multiple images to GIF format for animation purposes.

Properties

Name Meaning
Public ID The public identifier of the asset in Cloudinary, including any folder path but excluding the file extension. This is required to specify which image to transform.
Type The Cloudinary delivery type, which determines the URL path segment for accessing the asset. Typically set to 'Upload' for public assets. Other types like 'Private' or 'Authenticated' require signed URLs which are not generated by this node.
Continue From Transformation An optional transformation string to prepend before this operation's transformation, allowing chaining of multiple transformations into one delivery URL.
Target Format The desired image format to convert to, such as AVIF, GIF, JPG, PNG, or WebP.
Additional Options Optional additional transformation options, such as specifying a version to bust CDN caches.

Output

JSON

  • transformation - The transformation string representing the image format conversion and any additional options applied.
  • url - The full delivery URL of the transformed image in the target format.

Dependencies

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

Troubleshooting

  • If the node throws an error about unsupported operations, verify that the resource is set to 'Transform' and the operation to 'Image: Convert Format'.
  • Delivery URLs for 'Private' or 'Authenticated' types will fail to load unless signed URLs are generated, which this node does not support yet. Use 'Upload' type for public assets.
  • Ensure the Public ID is correct and does not include the file extension.
  • If transformations do not apply as expected, check the 'Continue From Transformation' input to ensure proper chaining of transformations.

Links

Discussion