Actions9
Overview
The "Join/Combine Images" operation of the Mallabe Images node allows users to merge two images into a single image either vertically or horizontally. This is useful in scenarios where you want to create composite images, such as combining product photos side-by-side for comparison, creating banners by stacking images, or generating before-and-after visuals.
For example, you could join two promotional images horizontally to create a combined banner for social media, or stack two event photos vertically for a newsletter.
Properties
| Name | Meaning |
|---|---|
| First Image URL | Public URL of the first image file to join |
| Second Image URL | Public URL of the second image file to join |
| Direction | Direction of the merged image: Vertical (stack images top-to-bottom) or Horizontal (side-by-side) |
| Images Alignment | Alignment of images when sizes differ: Start (top or left), Center, or End (bottom or right) |
| Background Color | Hex color code used as background fill behind images if they do not align perfectly |
| Offset | Number of pixels as spacing between the joined images |
| Download Image? | Whether to download the resulting image binary data (true) or just return a link (false) |
| Put Output File In Field | The name of the output field to store the binary image data when downloading (data by default) |
| Webhook URL (Advanced) | Optional URL to send a webhook with the operation's data |
Output
The node outputs JSON data containing information about the newly created joined image, including a URL to access it.
- If Download Image? is set to
false, the output JSON includes a direct URL to the combined image. - If Download Image? is set to
true, the node downloads the image binary data and places it in the specified output field (default"data"). This binary data can then be passed to other nodes that accept binary files.
The output structure looks like this:
{
"json": {
"url": "https://cdn.mallabe.com/processed/joined-image.png",
...
},
"binary": {
"data": {
"data": "<binary image data>",
"mimeType": "image/png"
}
}
}
Dependencies
- Requires an active API key credential for the Mallabe Images service.
- The node makes HTTP POST requests to the Mallabe Images API endpoint
/v1/images/join. - For downloading image binaries, it uses a CDN request to fetch the processed image from the returned URL.
- Optional webhook URL can be provided to receive asynchronous notifications or callbacks.
Troubleshooting
- Invalid Image URLs: The node requires publicly accessible image URLs. Protected or private URLs may cause failures.
- Unsupported Image Formats: Input images must be standard web formats (PNG, JPEG, etc.). Unsupported formats may not process correctly.
- API Authentication Errors: Ensure the API key credential is valid and has permissions for image processing.
- Download Failures: If downloading the image binary fails, check network connectivity and that the returned URL is accessible.
- Offset and Alignment Issues: Incorrect offset values or alignment settings might produce unexpected layouts; verify these parameters carefully.
- Webhook URL Misconfiguration: If using the webhook feature, ensure the URL is reachable and properly handles incoming data.