Edit Image+

Edits an image like blur, resize or adding border and text

Actions13

Overview

The Edit Image+ node for n8n allows you to perform advanced image editing operations directly within your workflows. Specifically, the Blur operation applies a customizable blur effect to an input image. This is useful in scenarios where you need to anonymize sensitive information, create artistic effects, or soften images before further processing.

Practical examples:

  • Blurring faces or text in images for privacy before sharing.
  • Softening product photos for background use in marketing materials.
  • Preprocessing images for machine learning tasks that require reduced detail.

Properties

Below are the supported input properties for the Blur operation:

Display Name Type Description
Property Name String Name of the binary property in which the image data can be found.
Blur Number How strong the blur should be (range: 0–1000).
Sigma Number The sigma of the blur (range: 0–1000).
Options Collection Additional options for output formatting and metadata. Includes:
  File Name String File name to set in binary data.
  Format Options Output image format (bmp, gif, jpeg, png, tiff, webp). Default: jpeg.
  Quality Number Compression level for jpeg, png, or tiff formats (0–100, best at 100).

Output

The node outputs the processed image in the specified binary property. The structure is as follows:

{
  "json": { ... },        // Original item JSON data
  "binary": {
    "<Property Name>": {
      "data": "<base64 image data>",
      "mimeType": "image/<format>",       // e.g., image/jpeg
      "fileExtension": "<format>",        // e.g., jpeg
      "fileName": "<custom or original file name>" // if provided
    },
    ...
  },
  "pairedItem": { "item": <index> }
}
  • The <Property Name> key matches the value you provide in the Property Name field.
  • If a file name is specified in Options, it will be used in the output.
  • The output always contains the blurred image in the chosen format and quality.

Dependencies

  • External Libraries:
  • n8n Requirements:
    • No special API keys or credentials required for the blur operation.
    • Node must have access to the binary data property containing the image.

Troubleshooting

Common issues:

  • Missing Binary Data:
    Error message: No binary data property "<Property Name>" exists on item!
    Resolution: Ensure the input item has the correct binary property with image data.

  • Invalid Parameter Values:
    Error message: May throw validation errors if blur or sigma values are out of range.
    Resolution: Use values within the allowed range (0–1000).

  • Unsupported Format:
    Error message: Errors related to image format conversion.
    Resolution: Choose a supported output format in the Options collection.

  • Large Images or High Blur Values:
    Issue: Processing may be slow or run out of memory.
    Resolution: Use reasonable image sizes and blur values.

Links and References

Discussion