Composite images

Node catalog Transformations

On this page

Add a logo or image at a selected position.

Usage and specifics

Supply the source image and operation settings. Dimensions and coordinates use pixels. Inspect the returned format, dimensions and MIME type before storing or sending.

Technical type : composite_image. Runtime : nodulz.

Credentials and prerequisites

This node defines no dedicated external credential. Remote sources or execution targets may still need their own access credentials.

See the credentials guide if a remote source or execution target requires access.

Parameters

Names below are technical keys. Defaults are not a ready-to-run configuration: complete fields required by your operation. Paths containing [] describe list items; some fields depend on the selected mode.

Parameter	Type	Default	Values / limits
`input`	`string`	`""`	-
`overlay`	`string`	`""`	-
`position`	`enum`	`"southeast"`	`northwest`, `north`, `northeast`, `west`, `centre`, `east`, `southwest`, `south`, `southeast`

Configuration help

input Source image: HTTP(S) URL, base64, data URL or full image node output. EXIF orientation is applied before processing. Only the first frame of animated images is processed.
overlay Overlay image: Image or transparent logo using the same input formats as the source. It must fit inside the base image; resize it beforehand.

Initial configuration

Initial catalog configuration example, to adapt before running. Keep secrets in credentials.

json

{
  "input": "",
  "overlay": "",
  "position": "southeast"
}

Verification

Test with representative data. Check node output in the inspector and logs, then use editor mapping for downstream fields. A trigger test with a simulated payload does not validate external service delivery.