Processare e Modificare Immagini con il Nodo "Edit Image"

Hai asset grafici da adattare per blog, social e ADV? Con il nodo edit image n8n puoi automatizzare l’intero ciclo: scaricare immagini da URL o storage, applicare ritaglio e ridimensionamento, aggiungere overlay, watermark e testo, convertire il formato, leggere metadati ed EXIF, e salvare il risultato su cloud. In questa guida trovi una panoramica completa del nodo di editing immagini in n8n, requisiti ambientali, parametri delle operazioni principali e flussi pronti per la produzione. Vedremo come mappare correttamente le proprietà binarie n8n immagini tra i nodi (da HTTP Request/Read-Write Files al nodo Edit Image), come scegliere formati immagine JPEG PNG WebP TIFF, come controllare qualità e compressione immagini e preservare la trasparenza e canale alpha. Chiudiamo con best practice su performance, batch processing e troubleshooting degli errori più comuni. Obiettivo: trasformare l’editing in una pipeline ripetibile e affidabile per automazione workflow immagini di marketing e SEO.

📚 Nuovo a n8n? Parti dalla guida completa: cos’è n8n e come funziona.

[IMG: Panoramica: HTTP Request (download) → Edit Image (Resize/Crop/Text/Composite) → Get Information → Save to Cloud → Log]

Panoramica rapida: dove si inserisce Edit Image nel tuo workflow

Ingest: recupera l’immagine con un nodo sorgente (HTTP Request con Download attivo, o Read/Write Files from Disk). Imposta la proprietà binaria (es. “data”) che conterrà il file.
Trasformazione: applica una o più operazioni con il nodo Edit Image: ritaglio e ridimensionamento immagini, overlay, watermark e testo su immagine, rotazioni, trasparenze, multi‑step.
Output: configura File Name e Format per ottenere il tipo file desiderato (bmp, gif, jpeg, png, tiff, WebP) e passa il binario a nodi di salvataggio (S3, Google Drive, FTP) o pubblicazione.

Requisiti ambientali (GraphicsMagick per n8n)

Se NON esegui n8n in Docker, installa GraphicsMagick sul sistema host per abilitare le operazioni grafiche.
Verifica con un test semplice (Resize su un’immagine di esempio) prima di andare in produzione.

Flusso dei binari tra i nodi

L’immagine viaggia dentro una proprietà binaria. Il nome della proprietà deve essere coerente tra nodi: il nodo Edit Image la legge dal campo “Property Name” e produce in output un nuovo binario (stessa property se non cambiato, o la property impostata nelle opzioni).
Mantieni naming costante (es. “data” in ingresso e uscita) per ridurre mapping e confusione.

Operazioni supportate: cosa fa ciascuna e quando usarla

Il nodo Edit Image supporta queste operazioni (nomi esatti):

Blur: aggiunge sfocatura (riduce la nitidezza).
Border: aggiunge un bordo con larghezza/altezza e colore.
Composite: compone un’immagine sopra un’altra (overlay, watermark, badge).
Create: crea un’immagine vuota con colore di sfondo e dimensioni.
Crop: ritaglia a dimensioni/posizioni specifiche.
Draw: disegna primitive (Circle, Line, Rectangle) con colore e coordinate.
Get Information: restituisce informazioni sull’immagine (utile per metadati).
Multi Step: esegue operazioni multiple in sequenza in un solo nodo.
Resize: cambia dimensioni con diverse opzioni di mantenimento/ignorare ratio.
Rotate: ruota l’immagine (–360 a 360 gradi) con colore di background per riempimento se serve.
Shear: deforma lungo asse X/Y di un certo numero di gradi.
Text: scrive testo sull’immagine con font size/colore e posizionamento.
Transparent: rende trasparente un colore specifico.

Combinazioni ricorrenti per marketing/SEO

Resize + Composite + Text: per creare una card social ottimizzata con logo e titolo.
Crop + Resize: per adattare correttamente il rapporto d’aspetto richiesto dalla piattaforma.
Get Information + Branching: per decidere dinamicamente se comprimere o meno in base a dimensioni/metadata.

[IMG: Tabella concettuale: operazione → scopo → parametri chiave]

Parametri chiave per operazioni frequenti (Crop, Resize, Text, Composite)

Di seguito i campi principali così come esposti nel nodo (UI):

Crop parameters

Property Name: nome della proprietà binaria contenente l’immagine.
Width: larghezza del ritaglio.
Height: altezza del ritaglio.
Position X: coordinata X di partenza del ritaglio (orizzontale).
Position Y: coordinata Y di partenza del ritaglio (verticale).

Resize parameters

Property Name
Width
Height
Option:
Ignore Aspect Ratio
Maximum Area
Minimum Area
Only if Larger
Only if Smaller
Percent

Text parameters

Property Name
Text: contenuto testuale da scrivere.
Font Size
Font Color
Position X
Position Y
Max Line Length
Opzione extra nell’area “Node options” per Font Name or ID.

Composite parameters

Property Name: immagine base.
Composite Image Property: property binaria dell’immagine da sovrapporre.
Operator (Add, Atop, Over, Multiply, ecc.)
Position X / Position Y: posizionamento dell’overlay.

Node options (output)

File Name: nome file in uscita.
Format: bmp, gif, jpeg, png, tiff, WebP.

Suggerimento pratico

Per testo multiriga leggibile, usa Max Line Length e posizioni leggermente “inset” (padding interno) per evitarlo a filo bordo.

Step‑by‑step: tre pipeline pronte all’uso

Ridimensiona per Web + salva in WebP

Sorgente: HTTP Request (Download: true, Binary Property: “data”).
Nodo: Edit Image → Operation: Resize
Property Name: data
Width: 1200, Height: 1200
Option: Maximum Area (mantiene rapporto, non supera le dimensioni)
Node options
File Name: ={{ $json.slug || ‘image’ }}-web.webp
Format: WebP
Salvataggio: Google Drive/S3 con la stessa property binaria.

[IMG: Configurazione Resize e opzioni di output in WebP]

Watermark logo + testo titolo

Sorgente: immagine base “data”, logo in “logo” (binario).
Nodo: Edit Image → Operation: Composite
Property Name: data
Composite Image Property: logo
Operator: Over
Position X/Y: 24/24 (angolo in alto a sinistra con padding)
Nodo: Edit Image → Operation: Text
Property Name: data
Text: ={{ $json.title }}
Font Size: 36
Font Color: #FFFFFF
Position X/Y: 24/96
Max Line Length: 40
Node options finali: File Name dinamico, Format “png” per preservare trasparenza se presente.

[IMG: Overlay del logo e testo con posizioni e colore impostati]

Crop quadrato per social + compressione JPEG

Nodo: Edit Image → Operation: Crop
Property Name: data
Width/Height: 1080/1080
Position X/Y: calcolate in base a Get Information (opzionale) o fissate a 0/0 se vuoi top‑left.
Nodo: Edit Image → Operation: Resize (opzionale per ridurre ulteriormente)
Width/Height: 1080/1080
Option: Ignore Aspect Ratio (se già croppata, non cambia)
Node options
File Name: ={{ $json.slug }}-1080.jpg
Format: jpeg

[IMG: Ritaglio quadrato con anteprima e salvataggio in JPEG]

Formati, qualità e trasparenza: scegliere l’output giusto

Formati disponibili (exact): bmp, gif, jpeg, png, tiff, WebP

JPEG: foto e grafiche senza trasparenza; peso contenuto, ottimo per web.
PNG: grafica con trasparenza/canale alpha, testi nitidi, loghi.
WebP: bilanciamento qualità/peso moderno con supporto ampio; consigliato per web moderno.
TIFF/BMP/GIF: casi specifici (archiviazione, compatibilità).

Qualità e compressione immagini

Il nodo espone “Format” e “File Name”; la qualità/compattazione dipende dal backend GraphicsMagick e dalle impostazioni implicite del formato. Per JPEG/WebP punta a dimensioni sorgente adeguate (Resize) prima di scrivere l’output.
Mantieni una libreria di “preset” (es. web‑large, web‑thumb) per coerenza.

Trasparenza e canale alpha

PNG/WebP gestiscono trasparenza. Se applichi Rotate o Composite, imposta sfondi coerenti (Background Color dove previsto) per evitare artefatti.

Compatibilità coi nodi successivi

Definisci l’estensione coerente al formato scelto in File Name per evitare mismatch di formati/estensioni nei salvataggi o nelle CDN.

Proprietà binarie e integrazione con nodi sorgente/destinazione

Flusso tipico

HTTP Request (Download: true) → Binary Property: “data”
Edit Image → Property Name: data
Salvataggio (S3/Drive/FTP) → Binary Property: data

Best practice di naming

Usa “data” come default e mantienilo in tutta la pipeline; se devi usare più asset (base + overlay), assegna proprietà diverse (es. “data” e “logo”) e referenziale in Composite con “Composite Image Property”.

Verifiche passo‑passo

Aggiungi un nodo “Get Information” per estrarre dimensioni e verificare il risultato dopo Resize/Crop.
Se concatenando più Edit Image riscontri confusione, imposta File Name diversi per gli step intermedi per ispezionare il flusso.

Esempio: naming dinamico del file

// Code node prima di Edit Image (Node options → File Name usa questa variabile)
const slug = ($json.slug || 'asset').toString().toLowerCase().replace(/[^a-z0-9-]+/g,'-');
return [{ json: { ...$json, fileBase: slug } }];

Poi in Edit Image → Node options → File Name: ={{ $json.fileBase }}-web.webp

Metadati ed EXIF: controllo qualità e branching

Get Information parameters

Property Name: imposta la property da analizzare (es. data).

Uso pratico

Leggi larghezza/altezza e decidi se applicare Resize o saltare lo step (“Only if Larger” è utile anche in Resize).
Usa i metadati per arricchire log e KPI (dimensioni prima/dopo).

Applicazioni per marketing

In un template n8n per elaborazione immagini, puoi filtrare immagini troppo piccole per determinate creatività, rimandando l’item a un ramo di fallback (richiesta asset ad alta risoluzione).

Performance e affidabilità: batch, caching e troubleshooting

Performance

Batch processing: usa Split In Batches per elaborare lotti di immagini e rispettare rate e risorse.
Caching: se rigeneri lo stesso formato per lo stesso asset, prevedi salvataggio e skip se già presente su storage.
Peso file: riduci dimensioni a monte (Resize/Maximum Area) prima di salvare in formati compressi.

Errori comuni e fix

Proprietà binaria non trovata: assicurati che “Property Name” nel nodo Edit Image corrisponda alla property impostata nel nodo sorgente (es. HTTP Request → Binary Property: data).
Mismatch formato/estensione: se salvi in JPEG ma File Name termina con .png, correggi “Format” o l’estensione.
Font mancanti per Text: se usi “Font Name or ID”, verifica che il font sia disponibile nel sistema o scegli uno standard; in alternativa, usa un nome/ID valido.
Coordinate Crop errate: “Position X/Y” è la partenza del ritaglio; se ottieni aree vuote, verifica dimensioni originali con “Get Information”.
Background Color su Rotate: se ruoti con angoli non multipli di 90°, imposta un colore adeguato per riempire eventuali aree.

Sicurezza e gestione errori

Aggiungi rami di retry/backoff se l’ingest (HTTP) fallisce.
Registra risultati e anomalie (dimensioni inaspettate, fallimenti di conversione) su un foglio/DB per audit.

Quick Takeaways

Mantieni coerente la proprietà binaria (es. “data”) dall’ingest al salvataggio e impostala in “Property Name” nel nodo Edit Image.
Usa Resize con “Maximum Area” per ridurre peso mantenendo il rapporto; WebP/PNG/JPEG come formati principali.
Per overlay/watermark, usa Composite con “Composite Image Property” e posizioni X/Y con padding.
Per testo leggibile, definisci Font Size/Color e Max Line Length; verifica la disponibilità del font.
Get Information ti aiuta a decidere rami (es. applicare Resize solo se più grande) e a loggare KPI.
Batch e caching migliorano performance; valida estensione/format per evitare mismatch nei salvataggi.

Conclusione

Automatizzare l’editing con il nodo edit image n8n significa passare da interventi manuali a pipeline affidabili: ingest, trasformazioni, output coerenti e salvataggio su cloud. Conoscere bene i parametri di Crop, Resize, Text e Composite, scegliere formati adatti (JPEG/PNG/WebP/TIFF) e mantenere una proprietà binaria coerente ti mette al riparo da errori e rifacimenti. Integra “Get Information” per decisioni data‑driven (dimensioni, qualità), applica batch per performance e usa naming dinamico per tracciare versioni e varianti. Inizia da un caso d’uso concreto (thumbnail per blog, card social con watermark, compressione web), costruisci uno o due preset e applicali ovunque ti serva. In poche iterazioni avrai una libreria di workflow riutilizzabili che alleggerisce il carico del team marketing e garantisce asset sempre pronti per pubblicazione e campagne.

FAQ

Come imposto correttamente la proprietà binaria tra i nodi?

Imposta in HTTP Request “Download: true” e scegli “Binary Property” (es. data). Nel nodo Edit Image, usa lo stesso valore in “Property Name”. Mantieni la coerenza anche nei nodi di salvataggio (S3/Drive) per evitare errori di mapping.

Quale formato devo scegliere per il web?

Per la maggior parte dei casi, WebP offre un buon rapporto qualità/peso. JPEG è ottimo per foto senza trasparenza, PNG per grafica con canale alpha. Imposta “Format” e un “File Name” con estensione coerente.

Come faccio a creare un watermark?

Usa “Composite”: imposta “Property Name” (immagine base) e “Composite Image Property” (logo), “Operator: Over” e “Position X/Y” con un piccolo padding. Se serve testo, aggiungi un secondo step “Text”.

Come riduco il peso mantenendo qualità accettabile?

Applica “Resize” con “Maximum Area” per limitare dimensioni e poi scrivi in WebP/JPEG. Verifica dimensioni con “Get Information” per evitare ridimensionamenti inutili (“Only if Larger” aiuta).

Perché l’operazione “Text” non usa il font che voglio?

Verifica “Font Name or ID” nelle opzioni del nodo “Text”: il font deve essere disponibile nel sistema. In ambienti server, usa font standard o installa i tuoi TrueType, poi referenziali per nome/ID corretto.

Hai trovato utile questa guida?

Qual è la prima pipeline che automatizzerai: resize+WebP per il blog o watermark+testo per i social? Condividi la tua scelta con il team e confrontiamo preset e risultati per ottimizzare il flusso di editing!

Processare e Modificare Immagini con il Nodo “Edit Image”