A Convert Image node converts each incoming image to another format, optionally resizing it, and passes on the converted file. Use it to produce web-ready JPEG or WebP versions of camera files, to standardize the images partners send in many formats, or to create thumbnails at a fixed width.

Convert Image accepts only file items, because it reads a file's contents. It uses the same conversion as Transforming Files, which lists the input and output formats for images.

Settings

The node takes the target format and an optional width and height in pixels. With one dimension, the image is scaled to it. With both, the image is scaled to fit within those dimensions. The aspect ratio is preserved in both cases. The optional destination path takes the same tokens and templates as every destination, and the overwrite setting is off by default, so an existing file at the destination fails the item with processing-failure/destination-exists instead of being replaced.

What the Next Node Receives

Convert Image passes on one file item for each converted image. The original file is unchanged.

Errors

A file that is not an image in one of the input formats fails that item. Error Handling rules on the node determine what happens to a failed item.