Convert image

• Type image.convert
• Group MZBase
• Role action
• Risk reads only
• Side effect none
• Runs once per item
• Needs media

Converts an image to JPG, PNG or WebP

Also available to AI agents and over MCP as a tool.

Parameters

source

Source · string · required · default binary · one of binary, media

Where the input file comes from: the item’s file (binary), a media library item, or a URL.

binaryProperty

File field · string · optional · default data

Shown when source is binary.

mediaId

Media · string · optional

Shown when source is media.

format

Format · string · optional · default jpg · one of jpg, png, webp

The output format (JPEG, PNG, WebP).

quality

Quality · integer · optional · default 90 · range 1 – 100

stripMetadata

Remove metadata · boolean · optional · default true

Remove EXIF data (camera, GPS) from the file.

into

Into field · string · optional · default data

saveTo

Save to · string · optional · default none · one of none, media

Where the result goes: back on the item as a file, or into the media library (the item then gets mediaId).

mediaFolder

Media folder · string · optional

Shown when saveTo is media.

mediaTags

Media tags · array · optional

Shown when saveTo is media.

Outputs

• main

← All nodes