Burn subtitles

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

Burns SRT or VTT subtitles into a video

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.

subtitleFrom

Subtitles from · string · optional · default text · one of text, binary

Subtitles from a field (SRT text) or a file.

subtitles

Subtitles · string · optional

Shown when subtitleFrom is text.

subtitleProperty

Subtitles property · string · optional · default subtitles

Shown when subtitleFrom is binary.

font

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

color

Colour · string · optional · default #ffffff

outlineColor

Outline colour · string · optional · default #000000

position

Position · string · optional · default bottom · one of bottom, center, top

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