Image

Image integration · 21 node(s) including 1 trigger.

00Overview

Edit and generate images directly inside a flow — resize, crop, rotate, convert between formats, compress, and add borders, watermarks, rounded corners or text captions, then build montages and multi-page PDFs or read back dimensions and dominant colours. It also works with Photoshop files: inspect a PSD's layers, export them as separate PNGs, flatten it to a web image, or swap a named text layer for personalised copy. Everything runs on the flow's own runner, so your images never leave your environment.

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Image

The Image actions have no account, API key or OAuth to connect — every operation runs locally on your Flomation runner using the ImageMagick command-line tool, so there are no credentials to create and images never leave your environment.
Make sure ImageMagick is installed on the runner host: the actions call magick (v7) and fall back to convert (v6), and will report that ImageMagick was not found on the PATH if neither is present.
For AVIF or WebP output, confirm your ImageMagick build includes the matching delegate libraries (for example libheif for AVIF) — a minimal install may only handle PNG, JPEG, GIF and TIFF.
If the binary lives outside the system PATH, point the runner at it explicitly with the FLOMATION_MAGICK_PATH environment variable.
Supply images by wiring a file or blob reference from an earlier step — an upload, HTTP download or storage node — into each action's Image field; there is nothing to log in to.

02Adjust

Adjust Image

image/adjust · Action

Apply an effect: grayscale, sepia, blur, sharpen, brightness or contrast

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Effect	`string`		choices: Grayscale, Sepia, Blur, Sharpen, Brightness, Contrast
Amount (effect-dependent)	`integer`

Returns: tool_result, image, size_bytes, success, error

03Autocrop

Auto-crop Image

image/autocrop · Action

Automatically trim a uniform (e.g. whitespace) border from an image

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Colour tolerance (%)	`integer`

Returns: tool_result, image, width, height, size_bytes, success, error

04Border

Add Border

image/border · Action

Add a solid colour border around an image

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Border width (px)	`integer`
Colour	`string`		black, #ffffff

Returns: tool_result, image, size_bytes, success, error

05Convert

Convert Image Format

image/convert · Action

Convert an image to PNG, JPEG, WebP, GIF, TIFF or AVIF

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Target format	`string`		choices: PNG, JPEG, WebP, GIF, TIFF, AVIF
Quality (1–100, lossy formats)	`integer`

Returns: tool_result, image, format, size_bytes, success, error

06Create

Create Image

image/create · Action

Create a new blank image of a given size and colour

Field	Type	Details
Width (px)	`integer`
Height (px)	`integer`
Colour	`string`	white, #ff0000, transparent
Format	`string`	choices: PNG, JPEG

Returns: tool_result, image, width, height, size_bytes, success, error

07Crop

Crop Image

image/crop · Action

Crop a rectangular region from an image by position and size

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Left offset (px)	`integer`
Top offset (px)	`integer`
Width (px)	`integer`	Required
Height (px)	`integer`	Required

Returns: tool_result, image, width, height, size_bytes, success, error

08Info

Get Image Info

image/info · Action

Read an image's width, height and format

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…

Returns: tool_result, width, height, format, size_bytes, success, error

09Montage

Montage / Grid

image/montage · Action

Arrange several images into a grid (contact sheet or collage)

Field	Type		Details
Image references (one per line, in order)	`text`	Required	flo:file:… flo:blob:…
Columns	`integer`
Cell size (px)	`integer`
Spacing (px)	`integer`
Background colour	`string`

Returns: tool_result, image, image_count, size_bytes, success, error

10Optimize

Optimize Image

image/optimize · Action

Strip metadata and recompress an image to reduce its file size

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Quality (1–100, lossy formats)	`integer`

Returns: tool_result, image, size_bytes, success, error

11Palette

Image Colour Palette

image/palette · Action

Extract an image's dominant colours as hex codes

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Number of colours	`integer`

Returns: tool_result, colours, count, success, error

12Psd

Extract PSD Layers

image/psd_extract_layers · Action

Export individual PSD layers as separate PNG images

Field	Type		Details
PSD file (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Layer names to extract (comma-separated, blank = all named)	`string`		logo, headline

Returns: tool_result, layers, count, success, error

PSD Info

image/psd_info · Action

Read a PSD's canvas size, colour mode and layer names/positions

Field	Type		Details
PSD file (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…

Returns: tool_result, layers, layer_count, width, height, colour_mode, success, error

Rasterise PSD

image/psd_rasterise · Action

Flatten a PSD to a PNG, JPEG or WebP image (from its embedded composite)

Field	Type		Details
PSD file (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Output format	`string`		choices: PNG (keeps transparency), JPEG, WebP
Quality (JPEG/WebP, 1–100)	`integer`
Max width (px, 0 = original; only downscales)	`integer`
Flatten onto colour (blank = keep transparency)	`string`		#ffffff

Returns: tool_result, image, width, height, size_bytes, success, error

Personalise PSD Text

image/psd_render_text · Action

Replace a named text layer in a PSD and render the result as an image

Field	Type		Details
PSD file (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Text layer name (exact, from PSD Info)	`string`	Required	headline
New text	`text`	Required	Hello Jane
Font	`string`		choices: Poppins Bold, Poppins SemiBold, Poppins Regular
Font size (px, 0 = auto-fit to the layer box)	`integer`
Text colour	`colour`		#000000, flomation-teal
Alignment	`string`		choices: Left, Centre, Right
Output format	`string`		choices: PNG, JPEG, WebP

Returns: tool_result, image, width, height, size_bytes, success, error

13Resize

Resize Image

image/resize · Action

Resize an image to a width and/or height with a chosen fit mode

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Width (px, 0 = auto)	`integer`
Height (px, 0 = auto)	`integer`
Fit mode	`string`		choices: Fit within (keep aspect), Fill & crop (cover), Stretch (ignore aspect)
Allow enlarging	`boolean`

Returns: tool_result, image, width, height, size_bytes, success, error

14Rotate

Rotate / Flip Image

image/rotate · Action

Rotate an image by 90/180/270° and/or flip it horizontally or vertically

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Rotate	`string`		choices: None, 90° clockwise, 180°, 270° clockwise
Flip	`string`		choices: None, Horizontal, Vertical

Returns: tool_result, image, size_bytes, success, error

15Round

Round Corners

image/round_corners · Action

Round the corners of an image (transparent PNG output)

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Corner radius (px)	`integer`

Returns: tool_result, image, size_bytes, success, error

16Text

Add Text to Image

image/text · Action

Draw a text caption onto an image at a chosen position, size and colour

Field	Type		Details
Image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Text	`text`	Required	Your caption
Font size (px)	`integer`
Colour	`string`		white, #ff0000, rgba(0,0,0,0.5)
Position	`string`		choices: Centre, Top left, Top right, Bottom left, Bottom right
X offset (px)	`integer`
Y offset (px)	`integer`

Returns: tool_result, image, size_bytes, success, error

17To

Images to PDF

image/to_pdf · Action

Combine one or more images into a single PDF, one image per page

Field	Type		Details
Image references (one per line, in order)	`text`	Required	flo:file:… flo:blob:…

Returns: tool_result, pdf, page_count, size_bytes, success, error

18Watermark

Watermark Image

image/watermark · Action

Overlay a watermark image onto another image at a chosen position and opacity

Field	Type		Details
Base image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Watermark image (file/blob reference)	`string`	Required	flo:file:… or flo:blob:…
Position	`string`		choices: Centre, Top left, Top right, Bottom left, Bottom right
Opacity (1–100)	`integer`
Margin (px)	`integer`

Returns: tool_result, image, size_bytes, success, error

19Triggers

Tracking Pixel Trigger

trigger/image · Trigger

Triggers a flow when a tracking pixel image is loaded

Returns: ip, user_agent, referrer, triggered_at

20Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

Every image and PSD input is a file or blob reference produced by an earlier step in the flow, not a URL or a typed path, so chain an upload, download or storage node ahead of these actions to supply one.
Each operation is bounded by a 120-second time limit and roughly 512 MiB of working memory, so very large or high-resolution source images can fail outright rather than simply run slowly.
AVIF and WebP output rely on the runner's ImageMagick build including the matching delegate libraries, so conversions to those formats may fail on a minimal installation.
Replacing a PSD text layer renders the new copy in the bundled Poppins family (Bold, SemiBold or Regular) rather than the layer's original typeface, and always returns a flattened image rather than an editable .psd.
Rasterising a PSD uses the flattened composite preview that Photoshop embeds on save and converts CMYK documents to sRGB, so a file saved without maximised compatibility may not reproduce faithfully.
Newly created blank canvases are capped at 10000 by 10000 pixels.