n8n 2.x ou n8n 3.0 : les différences et pourquoi mettre à jour

n8n 3.0 garde l’éditeur, les workflows, les identifiants et l’historique de la 2.x : elle retire les vieux nœuds, durcit les réglages par défaut et change le comportement de quelques nœuds courants. Mettez à jour dans les semaines qui suivent la version stable, annoncée pour début décembre 2026, parce que la 2.x ne recevra plus que des correctifs de sécurité et de bugs critiques pendant 12 mois, et que toutes les nouveautés arriveront en 3.x.

n8n 2.x ou 3.0 : les différences en un tableau

La 3.0 est une version de fondation : n8n la présente comme « centrée sur la fiabilité, la stabilité et la sécurité ». Elle ajoute peu de fonctions visibles et change surtout ce qui tourne sous le capot.

Point	n8n 2.x	n8n 3.0
Nouveautés	Plus aucune après la sortie de la 3.0 stable	Toutes les nouvelles versions
Correctifs	Sécurité et bugs critiques, pendant 12 mois	Tous
Nœuds Function, Item Lists, Cron, Interval, ancien OpenAI	Disponibles	Retirés, le workflow échoue
Planification	Cron, Interval ou Schedule Trigger	Schedule Trigger seul, sur un planificateur plus durable selon n8n
Délai par défaut du nœud Code	5 minutes	1 minute, réglable
Exécutions manuelles en mode file d’attente (queue mode)	Sur l’instance principale ou sur les workers, au choix	Toujours sur les workers
Données binaires	Mémoire possible	Disque ou stockage externe (S3 par exemple)
Rotation de la clé de chiffrement	Désactivée par défaut	Activée par défaut
Paquets communautaires non vérifiés	Chargés	Désactivés par défaut
Installation auto-hébergée	Docker ou npm	Docker seulement (Kubernetes et Helm inchangés)

Les remplaçants de chaque nœud retiré et les réglages d’instance un par un sont détaillés dans l’article sur la migration vers n8n 3.0.

Ce que vous gardez en passant en 3.0

Les identifiants et l’historique des exécutions passent tels quels en 3.0, et la mise à jour demande un redémarrage court, comme n’importe quelle mise à jour de version. L’éditeur, la logique des workflows, le bouton Publish arrivé avec la 2.0 et les nœuds encore maintenus restent les mêmes.

L’édition communautaire gratuite reçoit toute la 3.0, comme n8n Cloud et les offres Business et Enterprise. Une seule précaution pèse lourd : le passage est à sens unique. Une instance en 3.0 ne revient en 2.x qu’en restaurant une sauvegarde, d’où la sauvegarde complète avant de lancer quoi que ce soit.

Les changements qui ne déclenchent aucune erreur

Un nœud retiré se voit tout de suite, puisque le workflow échoue. Quatre changements passent plus discrètement : le workflow continue de tourner, avec un résultat différent.

• Gmail Trigger : il relève 10 mails par passage par défaut (50 au maximum), ignore les brouillons sauf si l’option Include Drafts est cochée, et ne se déclenche plus sur les mails envoyés ou programmés. Pour garder un déclenchement sur les mails envoyés, n8n propose un Schedule Trigger suivi du nœud Gmail en opération Get Many.
• If, Switch et les autres nœuds à plusieurs sorties, avec Always Output Data : un item vide n’est ajouté que si toutes les sorties sont vides. En 2.x, chaque sortie vide en recevait un, et des branches tournaient alors qu’elles n’auraient pas dû.
• Nœud Code : un script qui dépasse une minute s’arrête en erreur. En 2.x, il avait cinq minutes. Le cas typique, c’est le script qui parcourt un gros fichier ou attend une API lente, et qui passait large jusqu’ici.
• Chat Trigger : chaque message envoyé par WebSocket devient un objet JSON avec un champ type. Le widget officiel @n8n/chat doit être en version 1.31.0 ou plus, et un client maison doit lire ce JSON.

Le Slack Trigger, lui, prévient : sans signing secret dans l’identifiant Slack, le workflow refuse de se publier et le déclencheur répond par une erreur 401. Ajoutez le secret avant la mise à jour.

Sur n8n Cloud ou en auto-hébergé : ce qui vous concerne

Sur n8n Cloud, la mise à jour touche vos workflows et rien d’autre. En auto-hébergé, s’ajoutent l’installation et les variables d’environnement.

Changement	n8n Cloud	Auto-hébergé
Nœuds retirés, $getPairedItem retiré	Oui	Oui
Gmail Trigger, If et Switch, Chat Trigger	Oui	Oui
Signing secret Slack	Oui	Oui
Délai du nœud Code	Oui	Oui, réglable avec N8N_RUNNERS_TASK_TIMEOUT
Passage obligatoire à Docker	Non	Oui, si l’instance tourne avec npm ou npx n8n
Données binaires, dossier binaryData renommé en storage	Non	Oui
Paquets communautaires non vérifiés coupés	Non	Oui
Limites du nœud Compression (256 Mio, 1 000 fichiers)	Non	Oui, réglables

Une instance installée avec npm se bascule vers Docker avant la 3.0. La procédure est dans le guide pour installer n8n avec Docker, et si la gestion du serveur vous pèse, le comparatif n8n auto-hébergé ou Cloud aide à trancher.

Pourquoi mettre à jour vers n8n 3.0

La première raison tient au calendrier : après la sortie stable, la 2.x reçoit seulement les correctifs de sécurité et de bugs critiques, pendant 12 mois. n8n compte plus de 45 versions depuis la 2.0 de décembre 2025, environ une par semaine, et à partir de décembre ce rythme profite uniquement à la 3.x.

Les autres raisons concernent la fiabilité :

1. La planification passe entièrement par le Schedule Trigger, qui tourne sur un planificateur plus durable que Cron et Interval, d’après n8n.
2. En mode file d’attente, les exécutions manuelles partent toujours sur les workers : l’instance principale garde ses ressources pour l’éditeur et les déclencheurs. Vérifiez la mémoire des workers avant la bascule.
3. Les données binaires vivent sur disque ou dans un stockage externe, un fonctionnement que n8n décrit comme plus prévisible sous la charge.
4. Les réglages de sécurité sont plus stricts dès l’installation : rotation de la clé de chiffrement, paquets communautaires non vérifiés coupés, liste de blocage SSRF élargie quand la protection est active.

L’annonce ne donne aucun chiffre de vitesse : le gain attendu porte sur la fiabilité et sur l’accès aux nouveautés.

Quand mettre à jour : le verdict selon votre profil

Sur n8n Cloud sans nœud retiré, mettez à jour dès la version stable. En auto-hébergé, passez d’abord par une instance de test, et une instance installée avec npm ou encore en 1.x franchit une étape intermédiaire avant.

Votre situation	Verdict
n8n Cloud, aucun nœud retiré dans le rapport de migration	Mettez à jour dès la version stable, après un coup d’œil aux workflows Gmail, If et Switch
n8n Cloud, des nœuds Code longs ou des Gmail Trigger en production	Traitez le rapport de migration en novembre, testez la bêta sur un espace de test, mettez à jour en décembre
Auto-hébergé sous Docker	Mettez à jour dans les semaines qui suivent la stable, après une instance de test et une sauvegarde
Auto-hébergé avec npm	Basculez vers Docker en 2.x d’abord, puis passez en 3.0
Mode file d’attente avec plusieurs workers	Vérifiez la mémoire des workers, puis mettez à jour comme une instance Docker
Instance encore en 1.x	Passez en 2.x avant le 31 décembre 2026, fin du support de la 1.x, puis en 3.x : aucun chemin direct n’existe

Rester en 2.x jusqu’à la fin des 12 mois reste possible pour une instance figée qui tourne bien. Le coût arrive à la fin : une année de nouveautés et de changements à rattraper d’un coup, au lieu d’une liste encore fraîche aujourd’hui.

Par où commencer

Le rapport de migration, dans Settings > Migration Report à partir de la version 2.39, liste les workflows touchés et corrige une partie des nœuds tout seul.

1. Mettez l’instance à jour vers la dernière 2.x et ouvrez le rapport de migration.
2. Traitez chaque ligne : bouton Migrate quand il existe, correction à la main sinon, « Won’t fix » pour les workflows abandonnés.
3. Faites une sauvegarde complète de la base et des identifiants.
4. Passez une instance de test en 3.0, faites tourner les workflows critiques, puis mettez la production à jour.

Sur n8n Cloud, la bêta se choisit dans le changement de version de l’espace, sous le nom « 3.0.0 Beta (early access) ». Pour démarrer une instance neuve directement en 3.x sans serveur à gérer, n8n Cloud s’occupe de toute la partie installation. Et si un workflow casse malgré tout après la bascule, le guide de la gestion des erreurs dans n8n montre comment être prévenu tout de suite.

FAQ

Quelle est la différence entre n8n 2 et n8n 3 ?

n8n 3.0 retire les anciens nœuds (Function, Item Lists, Cron, Interval, l’ancien nœud OpenAI), ramène le délai du nœud Code à une minute, active des réglages de sécurité plus stricts et réserve l’auto-hébergement à Docker. L’éditeur, les identifiants et l’historique des exécutions restent les mêmes.

Faut-il mettre à jour n8n vers la version 3.0 ?

Oui, dans les semaines qui suivent la version stable : la 2.x ne reçoit plus que des correctifs de sécurité et de bugs critiques pendant 12 mois, et les nouveautés arrivent uniquement en 3.x. Traitez d’abord le rapport de migration et faites une sauvegarde.

Combien de temps la version 2 de n8n reste-t-elle maintenue ?

Après la sortie de la 3.0 stable, prévue début décembre 2026, la 2.x reçoit les correctifs de sécurité et de bugs critiques pendant 12 mois. Elle ne reçoit plus aucune nouvelle fonction.

Mes workflows vont-ils continuer à fonctionner en n8n 3.0 ?

La plupart, oui. Ceux qui utilisent un nœud retiré échouent, et ceux qui reposent sur le Gmail Trigger, sur If ou Switch avec Always Output Data, ou sur un nœud Code de plus d’une minute peuvent changer de résultat : le rapport de migration les liste.

n8n 3.0 est-il plus rapide que n8n 2 ?

n8n ne publie aucun chiffre de performance pour la 3.0. La version vise la fiabilité : planificateur plus durable, exécutions manuelles sur les workers, données binaires sur disque ou en stockage externe.

La mise à jour vers n8n 3.0 est-elle payante ?

Elle est incluse : l’édition communautaire gratuite reçoit toute la 3.0, comme n8n Cloud et les offres Business et Enterprise.

---

La mise à jour se passe bien quand on sait lire ses workflows : déclencheurs, transformation des données, conditions, boucles, gestion des erreurs. Ma formation n8n enseigne ces fondations en 31 leçons vidéo réparties en 4 chapitres. L’installation sur serveur, les agents IA et le MCP sont hors programme. Pour le reste de l’outil, le hub n8n regroupe les guides du site, dont l’article sur la migration vers n8n 2.0 pour les instances encore en 1.x.

Sources : n8n · Introducing n8n 3.0, n8n Docs · changements de la 3.0, n8n Docs · rapport de migration.