Resources · n8n integration

n8n Edit Image nodeConfigure Edit Image in n8n.

The n8n Edit Image node turns a binary file into a finished visual without leaving the canvas. It ships with 13 operations, from Crop and Resize to Text and Composite, and every one of them reads the picture from a binary property. Built for anyone assembling thumbnails, watermarks or report assets.

Verified Trustpilot reviews · AI, automation & growth agency

Why automate

What does the n8n Edit Image node actually do?

Edit Image manipulates a picture that is already inside your workflow. It never goes looking for the file itself: a previous node, such as Read/Write Files from Disk or HTTP Request, hands it the image as a binary property, and Edit Image writes the modified file back into that property. Thirteen operations cover blurring, borders, compositing, creation, cropping, drawing, information, multi step, resizing, rotation, shearing, text and transparency.

Three jobs come up again and again. The first is preparing an asset for publication: default.resize brings a photo down to the dimensions a channel expects, then default.text burns a headline onto it before the file goes out to Slack or as an attachment through Gmail.

The second is redaction. A screenshot arriving from a form or an inbox rarely ships as is, and default.blur softens the sensitive area while default.crop removes whatever sits outside the frame. Nothing leaves your instance to get there, which matters when the picture shows customer data.

The third is generating a visual from data you already hold. Start with default.create for a blank canvas in the color you want, draw a shape with default.draw, then stack a logo on top with default.composite. Feed the values from a row in Google Sheets and the same workflow produces one card per line.

Prefer a different route when the transformation is not really an image edit. If a rendering API does the work better, the HTTP Request node calls any HTTP endpoint and is the way to reach it; it is the fallback when a dedicated node misses an operation of an HTTP API, never for something that is not HTTP. And when a thumbnail only needs to exist on a platform that already builds one, such as YouTube, there is nothing to edit at all.

Two limits are worth knowing before you build. Outside Docker, the node depends on GraphicsMagick being installed on the machine running n8n. And chaining five separate Edit Image nodes works, but default.multiStep exists precisely so that a whole sequence runs inside one node. The n8n review covers how the wider platform handles binary data.

Actions

Which Edit Image operation do you need?

The Edit Image node exposes 13 operations. For each one: the node as you configure it in n8n, the required fields, and our field notes.

01

Blur Image

blur

What you see in n8n

Notes & use cases

Blur softens the whole picture so a face, a license plate or a messy background loses its detail before the file travels any further.

Key parameters

  • Property Name: the binary property holding the image data, usually data right after a download step.
  • Blur: how strong the blur should be, on a scale of 0 to 1000, where higher numbers wash out more detail.
  • Sigma: the sigma of the blur, also 0 to 1000, controlling how far each pixel bleeds into its neighbors.
Use cases
anonymize a support screenshot before it reaches a shared channel.
02

Border Image

border

What you see in n8n

Notes & use cases

A border paints extra pixels around the picture, which stops a pale visual from dissolving into a white page and gives a batch of assets the same frame.

Key parameters

  • Property Name: name of the binary property in which the image data can be found.
  • Border Width: the width of the border.
  • Border Height: the height of the border.
  • Border Color: color of the border, entered as a hex value or picked from the swatch.
Use cases
frame every product shot in a catalog with the same brand color.
03

Composite Image

composite

What you see in n8n

Notes & use cases

Compositing lays one picture on top of another and decides, pixel by pixel, how the two blend together.

Key parameters

  • Property Name: the binary property carrying the base image, the one underneath.
  • Composite Image Property: the binary property holding the image to place on top, often data2.
  • Operator: how the two images combine, from Over for a plain overlay to Multiply, Difference or CopyOpacity.
  • Position X and Position Y: horizontal and vertical position of the composite image.
Use cases
drop a logo into the corner of every visual in a campaign.
04

Create Image

create

What you see in n8n

Notes & use cases

Nothing incoming to edit? Create builds a brand new image from scratch, a flat canvas that the following nodes can draw on or write across.

Key parameters

  • Property Name: the binary property the new image is written into, ready for the next node.
  • Background Color: the background color of the image to create, as a hex value or from the color picker.
  • Image Width: the width of the image to create.
  • Image Height: the height of the image to create.
Use cases
generate a plain social card that Text then fills with the headline of the day.
05

Crop Image

crop

What you see in n8n

Notes & use cases

Cropping keeps a rectangle and throws the rest away, so a wide screenshot becomes the one panel that matters.

Key parameters

  • Property Name: the binary property that stores the image data to cut into.
  • Width: crop width, the horizontal size of the rectangle you keep.
  • Height: crop height, the vertical size of that same rectangle.
  • Position X and Position Y: the horizontal and vertical position to crop from.
Use cases
cut a uniform square avatar out of photos uploaded at any ratio.
06

Draw Image

draw

What you see in n8n

Notes & use cases

Draw puts a simple shape on the picture, which is enough to highlight an area or build a chart-like visual by hand.

Key parameters

  • Primitive: the shape to draw, one of circle, line or rectangle.
  • Color: the color of the primitive to draw.
  • Start Position X and Start Position Y: where the primitive begins.
  • End Position X and End Position Y: where it stops, which sets its size.
  • Corner Radius: the radius used to round the corners.
Use cases
circle the error message on an automated QA screenshot.
07

Get Information

information

What you see in n8n

Notes & use cases

Reading comes before writing. Get Information returns image information such as the resolution, and changes nothing in the file, which makes it the natural first step when the rest of the branch depends on the size of what arrived.

Key parameters

  • Property Name: the only field to fill, the binary property in which the image data can be found, typically data right after an upload.
Use cases
route oversized uploads to Resize and let correctly sized ones pass through untouched.
08

Multi Step

multiStep

What you see in n8n

Notes & use cases

One node, several edits. Multi Step performs multiple operations on the same image in sequence, so a crop, a resize and a caption no longer need three nodes wired one after the other.

Key parameters

  • Property Name: the binary property every step in the list reads and rewrites.
  • Operations: the operations to perform, added one by one with Add Operation; any of the other operations can go in the list.
Use cases
turn a raw photo into a ready-to-publish banner in a single step of the workflow.
09

Resize Image

resize

What you see in n8n

Notes & use cases

Resize changes the size of the image, and the interesting part is the rule it follows when the target shape does not match the original.

Key parameters

  • Width and Height: the new dimensions of the image.
  • Option: how to resize. ignoreAspectRatio forces the exact values, maximumArea and minimumArea treat them as a ceiling or a floor, onlyIfLarger and onlyIfSmaller skip images already in range, and percent reads both values as percentages.
Use cases
shrink every incoming attachment before it is stored, without distorting portraits.
10

Rotate Image

rotate

What you see in n8n

Notes & use cases

Rotation fixes a photo that arrived sideways, or tilts a visual on purpose for a layout.

Key parameters

  • Property Name: the binary property that stores the picture to turn.
  • Rotate: how much the image should be rotated, in degrees, anywhere from minus 360 to 360.
  • Background Color: the color filling the empty corners when the angle is not a multiple of 90; at a multiple of 90 there is no gap to fill and the value is ignored.
Use cases
straighten scans coming from a mobile app before they are archived.
11

Shear Image

shear

What you see in n8n

Notes & use cases

Shearing slants the picture along one axis, turning a straight rectangle into a parallelogram without cutting anything out of it.

Key parameters

  • Property Name: the binary property in which the image data can be found.
  • Degrees X: the horizontal shear, in degrees, which pushes the top and bottom edges sideways.
  • Degrees Y: the vertical shear, in degrees, which does the same along the other axis.
Use cases
give a screenshot a slanted perspective for a presentation slide.
12

Apply Text to Image

text

What you see in n8n

Notes & use cases

Text writes directly onto the picture, and the string usually comes from the data flowing through the workflow rather than being typed in.

Key parameters

  • Text: the text to write on the image, often an expression such as {{ $json.title }}.
  • Font Size and Font Color: size and color of the text.
  • Position X and Position Y: where the text begins on the canvas.
  • Max Line Length: the maximum number of characters before a line break is added.
Use cases
stamp a quote onto a background picture for a daily post.
13

Add Transparency to Image

transparent

What you see in n8n

Notes & use cases

Transparency removes one color from the picture and leaves a hole where it was, the quick way to lift a subject off a flat background.

Key parameters

  • Property Name: the binary property holding the image to treat.
  • Color: the color to make transparent, entered as a hex value or chosen from the swatch.
Use cases
strip the white background from a supplier logo so it can sit on a colored card built by Create and Composite.
Need help

Need help automating Edit Image with n8n?

A person reads every message.

FAQ

Edit Image in n8n, answered

01Is the Edit Image node free in n8n?
Yes. Edit Image is a core node, shipped with n8n itself, so there is nothing to install and no extra cost on top of what you already run. It behaves the same way on n8n Cloud, the hosted offering, and on a self-hosted instance installed with Docker or npm under the Community Edition and its Sustainable Use license. A workflow built in one place runs identically in the other. The only practical difference sits outside n8n: if you do not run n8n on Docker, GraphicsMagick has to be installed on the machine for the node to work.
02What do you need to set up before using Edit Image?
Nothing on the account side. This node has no credential and no Authentication selector, so there is no key to create, no scope to grant and no connection to test. What it does need is an image. Edit Image works on a binary property, meaning a file already attached to the item, so a node before it has to supply that file: Read/Write Files from Disk for something on the machine, or HTTP Request for something behind a URL. It also needs a starting point, since it does not open a workflow on its own: a Schedule Trigger, a Webhook or the trigger of another tool comes first.
03What are the limits of the n8n Edit Image node?
It edits, it does not fetch or store. The file has to arrive as a binary property and the result goes back into one, so downloading and saving belong to other nodes. Output is controlled by two options, File Name for the name of the output file and Format for its type, with bmp, gif, jpeg, png, tiff and WebP to choose from; the Text operation adds a Font Name or ID option. The catalog lists version 1 of the node. An older workflow can show an earlier version with fewer options, and a node never changes version on its own.
04When should you use Edit Image instead of HTTP Request?
Use Edit Image whenever the change you want is one of its 13 operations: cropping, resizing, rotating, shearing, blurring, bordering, drawing, compositing, creating, adding text, removing a color, reading information, or several of those at once with Multi Step. The work happens on your instance and the picture never leaves it. Reach for HTTP Request when the result needs a service the node cannot produce, a rendering or recognition API for example, since HTTP Request calls any HTTP endpoint. That is its role: the fallback when a dedicated node misses an operation of an HTTP API, and only for HTTP.
05n8n or Make for automated image editing?
It depends on four things. Hosting: n8n runs on your own server with Docker or npm, or on n8n Cloud, while Make is a hosted platform with no self-hosting option. Data control: an image processed on a self-hosted instance stays on that machine, which weighs heavily when the picture contains customer information. Cost model: Make bills by operation, so a workflow that edits thousands of images counts every step, whereas a self-hosted n8n does not. Visual logic: both build flows on a canvas, and the choice there comes down to which editor you and your team read faster.
Hack'celeration Lab

Get our weekly integration tips.

No spam. Unsubscribe anytime.