---
title: "merge · RUAL Documentation"
description: "Merge two images using sharp."
canonical: https://docs.rual.nl/block-types/files/file_composite_images
language: en
---

# merge

This block is part of the [`files`](https://docs.rual.nl/block-types/files) group and was last modified in core [`v12.1.1`](https://docs.rual.nl/core-versions/120101).

Merge two images using sharp.

- flow `flow`

- images required `file`

- default options required `object`

- options per image required `array` Will take the options based on the image index. Index 0 will be the first image overlayed.

- flow `flow`

- success `condition`

- error `value`

- file `file`

| `composite` |
| --- |

A typical wiring for [merge](https://docs.rual.nl/block-types/files/file_composite_images): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the merge block: typical wiring for merge.](https://docs.rual.nl/canvas-examples/file_composite_images.png)

### Version history

Introduced in [`v12.1.1`](https://docs.rual.nl/core-versions/120101).

### Service documentation