Add text to image

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

Writes a caption on an image

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.

text

Text · string · optional

The text written on the image.

font

Font · string · optional · default sansBold · one of sans, sansBold, serif, mono, display, handwriting

color

Colour · string · optional · default #ffffff

boxColor

Box colour · string · optional · default #00000080

position

Position · string · optional · default bottom · one of topLeft, top, topRight, left, center, right, bottomLeft, bottom, bottomRight, custom

Where the text goes on the image.

x

X · integer · optional

Shown when position is custom.

y

Y · integer · optional

Shown when position is custom.

margin

Margin · integer · optional · default 24 · range 0 – …

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