Recursos · Integración n8n

Nodo Rename Keys n8nConfigura Rename Keys en n8n.

Casi nunca dos herramientas llaman igual a sus campos. El nodo Rename Keys n8n cambia el nombre de las claves de cada item que lo atraviesa y deja los valores intactos. Bastan dos parámetros: una lista Keys con pares antes y después, y una colección Additional Options con una regla Regex.

Probar el nodo Rename Keys en n8nVer los 2 parámetros

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve el nodo Rename Keys n8n?

Rename Keys recoge los items que llegan y renombra los campos que le indiques. Una clave es el nombre dentro de un par nombre/valor: {{ $json.fecha_alta }} pasa a ser {{ $json.createdAt }} y el contenido sigue igual. El nodo se ejecuta sobre cada item entrante y no abre un workflow por sí solo, así que delante siempre hay un disparador: Schedule Trigger, Webhook o el trigger de una herramienta.

El caso más habitual es el del campo mal bautizado. Alguien creó la columna hace dos años con mayúsculas y acentos, y la API del otro lado espera nombres cortos en minúscula. En lugar de arrastrar esa traducción por todas las expresiones del workflow, un Rename Keys en medio zanja el asunto.

Segundo escenario: los datos que entran desde fuera. Un webhook, o sea una URL que un servicio externo llama con un contenido JSON, te entrega la forma que ese servicio ha decidido, no la tuya. Renombra justo después de recibir y el resto del workflow habla tu vocabulario. Se nota sobre todo cuando un nodo Switch enruta según un campo: la regla se lee sola porque el campo se llama como lo llama el negocio.

Tercer escenario: la limpieza a gran escala. Cuando una fuente pone el mismo prefijo a cuarenta columnas, teclear cada par a mano cansa. La opción Regex de Additional Options captura las claves por patrón y las reescribe de una pasada. Dos minutos de configuración frente a una tarde de clics.

Conviene saber también lo que el nodo no hace. Cambia nombres, nunca valores: en cuanto haya que calcular o rellenar un valor por defecto, el trabajo es de otro nodo, y ahí Edit Fields (Set) es el que se usa. Tampoco va a buscar nada: si el dato vive detrás de una API sin nodo dedicado, HTTP Request hace la llamada y Rename Keys ordena la respuesta antes de que llegue a Slack o a donde toque.

Hay una costumbre que ahorra depuración. Una expresión regular alcanza cualquier clave que encaje, incluidas las que el propio nodo acaba de renombrar unas líneas antes. Patrón amplio más lista Keys larga da nombres que nadie había previsto. Sé preciso, o parte el trabajo en dos nodos. Y si todavía estás decidiendo plataforma, la Reseña n8n entra en ese debate.

Parámetros

¿Qué parámetros ofrece Rename Keys ?

El nodo Rename Keys tiene 2 parámetros. Para cada uno: el nodo tal como lo configuras en n8n, qué cambia el parámetro y nuestras notas de campo.

01

Keys

keys

Lo que ves en n8n

Notas y casos de uso

Aquí va la lista de renombrados, par a par. El botón Add new key añade una fila, una por campo afectado. Lo que no aparece conserva su nombre.

Parámetros clave

  • Keys: la colección en sí, que se abre con Add new key y se rellena fila a fila.
  • Current Key Name: el nombre que el campo tiene ahora, por ejemplo currentKey. La notación por puntos llega a claves anidadas, con level1.level2.currentKey.
  • New Key Name: el nombre que llevará después, por ejemplo newKey, con la misma notación, level1.level2.newKey.
Casos de uso
un pedido llega con cust_email y el destino espera email. Un solo par alinea todo el lote.
02

Additional Options

additionalOptions

Lo que ves en n8n

Notas y casos de uso

Mientras esta colección siga cerrada, el nodo se limita a los pares de arriba. Ábrela con Add option cuando los nombres siguen un patrón y no una lista fija.

Parámetros clave

  • Regex: se añade con Add new regular expression y elige las claves por patrón.
  • Regular Expression y Replace With: el patrón que localiza las claves y el nombre que recibe cada clave localizada.
  • Case Insensitive: desactivado, el patrón distingue mayúsculas; activado, las ignora.
  • Max Depth: la profundidad máxima del reemplazo, -1 para ilimitado y 0 solo para el primer nivel.
Casos de uso
un export de facturación antepone el mismo prefijo a cada columna y una expresión lo borra en todas.
Necesitas ayuda

¿Necesitas ayuda para automatizar Rename Keys con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Preguntas frecuentes sobre Rename Keys

01¿Rename Keys viene incluido en n8n, en Cloud y en auto-alojado?
Sí. Rename Keys es un nodo core que viene con n8n: nada que instalar y ningún coste añadido por el lado de n8n. Se comporta igual en n8n Cloud, la oferta alojada por n8n, y en una instancia que alojes tú con Docker o npm, en Community Edition bajo licencia Sustainable Use. Un workflow montado en un sitio funciona en el otro sin tocar este nodo. La versión descrita aquí es la versión 1, la más alta del catálogo. Un workflow antiguo puede mostrar una versión anterior con menos opciones, y un nodo nunca cambia de versión por su cuenta: si te falta una opción de las descritas, mira por ahí.
02¿Qué credenciales necesita el nodo Rename Keys?
Ninguna. Este nodo no tiene credential, es decir, ningún juego de datos de acceso guardado en n8n, ni selector Authentication. Por eso esta página no incluye pasos de conexión. No hay nada que configurar en tu cuenta: colocas el nodo en el workflow, listas las claves y ejecutas. Trabaja solo con datos que ya circulan, así que la única condición es que algo por delante genere items. La autenticación se juega justo ahí, en el Schedule Trigger, el Webhook o el trigger de la herramienta que arranca el proceso.
03¿Qué límites tiene el nodo Rename Keys n8n?
Renombra, y poco más. Los valores pasan intactos, de modo que un workflow que deba calcular, completar o reformatear un valor necesita otro nodo para esa parte. Tampoco crea ni borra campos: una clave que no esté en la lista conserva su nombre, y un nombre inventado solo aparece si una clave existente se renombra así. La opción Regex pide rigor, porque una expresión regular puede afectar a cualquier clave que encaje, incluida una que el mismo nodo haya renombrado antes. La profundidad se controla con Max Depth: -1 para ilimitado y 0 para quedarte en el primer nivel del item.
04¿Cuándo usar Rename Keys en vez de otro nodo?
Cuando la forma de los datos ya está bien y solo fallan las etiquetas. Ese es su oficio, y hacerlo en un nodo visible es mejor que esconder el mapeo dentro de quince expresiones repartidas por el lienzo. En cuanto haya que cambiar un valor, deja de ser el nodo adecuado y toca uno que escriba valores de campo. Y si los campos primero hay que traerlos de una API HTTP sin nodo dedicado, HTTP Request hace la llamada y Rename Keys normaliza la respuesta después. La regla cabe en una línea: un nodo, una intención, para que quien abra el workflow más adelante lo entienda a la primera.
05¿n8n o Make para renombrar campos?
Depende de cuatro criterios, y el precio es solo uno. Make, antes Integromat, es una plataforma de automatización alojada, sin opción de auto-alojamiento, facturada por operación: un workflow que renombra campos sobre miles de items consume ese presupuesto. n8n corre en n8n Cloud o en tu propio servidor, algo que pesa cuando los datos que pasan por ahí no pueden salir de tu infraestructura. Las dos ofrecen lógica visual, así que la decisión rara vez se toma por el dibujo. Mira dónde viven los datos, qué tan previsible es tu volumen y qué modelo de coste acepta firmar tu equipo financiero.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.

Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones