Ressources · Intégration n8n

Nœud Rename Keys n8nConfigurer Rename Keys dans n8n.

Deux outils nomment rarement leurs champs pareil. Le nœud Rename Keys n8n change le nom des clés de chaque item qui le traverse, sans toucher aux valeurs. Deux paramètres suffisent : une liste Keys de couples avant/après, et une collection Additional Options qui abrite une règle Regex.

Tester le nœud Rename Keys sur n8nVoir les 2 paramètres

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Rename Keys n8n ?

Rename Keys prend les items qui arrivent et renomme les champs que tu listes. Une clé, c'est le nom dans un couple nom/valeur : {{ $json.date_creation }} devient {{ $json.createdAt }} et le contenu reste identique. Le nœud s'exécute sur chaque item entrant et n'ouvre pas un workflow tout seul, donc un déclencheur le précède toujours, Schedule Trigger, Webhook ou le trigger d'un outil.

Le cas typique, c'est le formulaire mal nommé. Les colonnes portent les noms qu'une personne a tapés un jour, avec des majuscules et des accents, et l'API en face attend des noms courts en minuscules. Plutôt que de trimballer cette gymnastique dans toutes les expressions du workflow, un Rename Keys au milieu règle la question une bonne fois.

Deuxième situation : les données qui viennent de l'extérieur. Un webhook, c'est-à-dire une URL qu'un service appelle avec un contenu JSON, te livre la forme choisie par ce service, pas la tienne. Renomme tout de suite après la réception et la suite du workflow parle ton vocabulaire. Ça change tout quand un nœud If teste un champ : la condition devient lisible, parce que le champ porte le nom que l'équipe utilise à l'oral.

Troisième situation : le ménage en masse. Quand une source préfixe quarante colonnes de la même façon, saisir chaque couple à la main devient pénible. L'option Regex d'Additional Options attrape les clés par motif et les réécrit d'un coup. Deux minutes de configuration au lieu d'une après-midi de clics.

Il faut aussi savoir ce que le nœud ne fait pas. Il touche aux noms, jamais aux valeurs : dès qu'une valeur doit être calculée ou remplie par défaut, le travail revient à un autre nœud, et Edit Fields (Set) est celui qu'on prend. Il ne va rien chercher non plus : si la donnée vit derrière une API sans nœud dédié, HTTP Request appelle l'endpoint, puis Rename Keys remet les noms d'aplomb avant l'envoi vers Gmail ou ailleurs.

Un réflexe évite des heures de debug. Une expression régulière frappe toutes les clés qui correspondent, y compris celles que le nœud vient de renommer juste avant. Motif large plus longue liste Keys, ça donne des noms que personne n'avait prévus. Reste précis, ou coupe le travail en deux nœuds. Et si le choix de la plateforme n'est pas encore tranché chez toi, l'Avis n8n creuse ce sujet.

Paramètres

Quels paramètres propose Rename Keys ?

Le nœud Rename Keys compte 2 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Keys

keys

Ce que tu vois dans n8n

Notes & cas d'usage

C'est la liste des renommages, saisie couple par couple. Le bouton Add new key ajoute une ligne, une par champ concerné. Tout ce qui n'est pas listé garde son nom d'origine.

Paramètres clés

  • Keys : la collection elle-même, qu'on ouvre avec Add new key et qu'on remplit ligne par ligne.
  • Current Key Name : le nom porté aujourd'hui par le champ, par exemple currentKey. La notation à points atteint les clés imbriquées, avec level1.level2.currentKey.
  • New Key Name : le nom qu'il portera ensuite, par exemple newKey, avec la même notation à points, level1.level2.newKey.
Cas d'usage
une fiche client arrive avec cust_email alors que l'outil de destination attend email. Un seul couple, et tous les items du lot sont alignés.
02

Additional Options

additionalOptions

Ce que tu vois dans n8n

Notes & cas d'usage

Tant que cette collection reste fermée, le nœud se contente des couples saisis au-dessus. Ouvre-la avec Add option quand les noms suivent un motif plutôt qu’une liste figée.

Paramètres clés

  • Regex : ajoutée via Add new regular expression, elle vise les clés par motif.
  • Regular Expression et Replace With : le motif qui repère les clés, puis le nom donné à chaque clé repérée.
  • Case Insensitive : désactivé, le motif tient compte de la casse ; activé, il l’ignore.
  • Max Depth : la profondeur maximale du remplacement, -1 pour illimité, 0 pour le premier niveau seulement.
Cas d’usage
un export comptable préfixe chaque colonne pareil. Une expression, et le préfixe saute partout.
Besoin d'aide

Besoin d'aide pour automatiser Rename Keys avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui reviennent sur Rename Keys

01Rename Keys est-il inclus dans n8n, sur Cloud comme en auto-hébergé ?
Oui. Rename Keys est un nœud core livré avec n8n : rien à installer, aucun coût supplémentaire côté n8n. Il se comporte de la même façon sur n8n Cloud, l'offre hébergée par n8n, et sur une instance que tu héberges toi-même en Docker ou en npm, en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne de l'autre sans retoucher ce nœud. La version décrite ici est la version 1, la plus élevée du catalogue. Un workflow ancien peut afficher une version antérieure, avec moins d'options, et un nœud ne change jamais de version tout seul : si une option manque dans ton panneau, regarde de ce côté.
02Quels credentials faut-il pour utiliser Rename Keys ?
Aucun. Ce nœud n'a pas de credential, c'est-à-dire pas d'identifiants enregistrés dans n8n, et pas de sélecteur Authentication. C'est la raison pour laquelle cette page ne comporte aucune étape de connexion. Rien à configurer côté compte : tu poses le nœud dans le workflow, tu listes les clés, tu exécutes. Il travaille uniquement sur des données qui circulent déjà, donc la seule condition, c'est qu'un nœud en amont produise des items. L'authentification, elle, se joue à cet endroit-là : Schedule Trigger, Webhook, ou le trigger d'un outil comme Slack.
03Quelles sont les limites du nœud Rename Keys n8n ?
Il renomme, et c'est tout. Les valeurs passent intactes, donc un workflow qui doit calculer, compléter ou reformater une valeur a besoin d'un autre nœud pour cette partie. Il ne crée ni ne supprime de champ non plus : une clé absente de la liste garde son nom, et un nom inventé n'apparaît que si une clé existante est renommée ainsi. L'option Regex demande de la rigueur, parce qu'une expression régulière peut toucher n'importe quelle clé qui correspond, y compris une clé renommée plus tôt dans le même nœud. La profondeur se règle avec Max Depth : -1 pour illimité, 0 pour rester au premier niveau de l'item.
04Quand prendre Rename Keys plutôt qu'un autre nœud ?
Quand la forme des données est bonne et que seuls les libellés clochent. C'est son métier, et le faire dans un nœud visible vaut mieux que de planquer le mapping dans quinze expressions éparpillées. Dès qu'une valeur doit changer, le nœud n'est plus le bon : il faut un nœud qui écrit des valeurs de champ. Et si les champs doivent d'abord être récupérés sur une API HTTP sans nœud dédié, HTTP Request fait l'appel, Rename Keys normalise la réponse ensuite. La règle utile tient en une ligne : un nœud, une intention, pour que la personne qui ouvre le workflow dans six mois comprenne tout de suite.
05n8n ou Make pour renommer des champs ?
Ça dépend de quatre critères, et le prix n'en est qu'un. Make, ex-Integromat, est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : un workflow qui renomme des champs sur des milliers d'items consomme ce budget. n8n tourne sur n8n Cloud ou sur ton propre serveur, ce qui compte quand les données qui transitent ne doivent pas quitter ton infrastructure. Les deux offrent une logique visuelle, donc le choix se joue rarement sur le dessin. Regarde plutôt où vivent les données, la régularité de tes volumes, et le modèle de coût que ta direction financière accepte de signer.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations