Clase 02 · Módulo 03
Expresiones desde cero
Expresiones desde cero
Qué logras en esta clase
Haces que un nodo use los datos que produjo otro, sin copiar nada a mano.
- Creas expresiones arrastrando campos.
- Lees y corriges una expresión escrita.
- Traes datos de cualquier nodo anterior.
- Sabes cuándo una expresión ya no es la herramienta.
02
Un hueco que se rellena solo
Una expresión es un hueco en un campo. n8n lo rellena con el dato de cada ítem en el momento de ejecutar.
03
Valor fijo o expresión
| Valor fijo | Expresión | |
|---|---|---|
| Qué escribes | Hola Ana | Hola {{ $json.cliente }} |
| Resultado | Igual para todos | Distinto en cada ítem |
| Sirve para | Textos y ajustes que no cambian | Todo lo que depende de los datos |
Cualquier parámetro de un nodo puede ser de un tipo o del otro: el destinatario de un correo, el nombre de un archivo, el número de una fila.
04
El camino corto: arrastrar
- Ejecuta el nodo anterior para que haya datos.
- Abre el nodo que quieres configurar.
- En el panel INPUT, ubica el campo que necesitas.
- Arrástralo hasta el parámetro y suéltalo.
n8n escribe la expresión por ti. Si arrastraste el campo cliente, en el parámetro queda {{ $json.cliente }}.
05
Leer lo que quedó escrito
{{ $json.cliente }}{{ }}: todo lo que está entre llaves dobles se calcula; lo de afuera es texto fijo.$json: los datos del ítem que el nodo está procesando en ese momento..cliente: el campo que quieres de ese ítem.
Se lee: «del ítem actual, dame el campo cliente».
06
Mira el resultado antes de ejecutar
Junto al campo, n8n muestra de inmediato el valor que la expresión produce con los datos de muestra.
Ese resultado es tu comprobación. Si esperabas un nombre y ves undefined, el campo no existe con ese nombre. Si ves [object Object], apuntaste a un dato anidado y te falta bajar un nivel.
07
Una vez por ítem
La expresión se evalúa una vez por cada ítem. Tres ítems, tres resultados, cada uno con su propio valor.
08
Mezclar texto fijo y datos
Puedes poner varias expresiones dentro de un mismo texto.
Hola {{ $json.cliente }}, tu pedido de ${{ $json.total }} está listo.Con el primer ítem de la cafetería queda: «Hola Ana Rojas, tu pedido de $7500 está listo». El signo peso está fuera de las llaves, así que es texto común.
Para mostrar el monto con punto de miles, espera a la clase 4.
09
Datos anidados y nombres con espacios
| Caso | Cómo se escribe |
|---|---|
| Campo simple | {{ $json.cliente }} |
| Campo dentro de otro | {{ $json.despacho.comuna }} |
| Nombre con espacios o tildes | {{ $json['Fecha de entrega'] }} |
| Primer elemento de una lista | {{ $json.productos[0] }} |
Las listas se cuentan desde cero: [0] es el primero, [1] el segundo. Si arrastras el campo, n8n elige la forma correcta.
10
Un dato de un nodo que quedó atrás
$json solo ve lo que entregó el nodo inmediatamente anterior. Para un nodo más lejano se usa su nombre:
{{ $('Leer pedidos').item.json.correo }}Se lee: «del nodo Leer pedidos, el ítem que corresponde a este, su campo correo».
El nombre va tal como aparece en el lienzo, con mayúsculas y espacios.
11
Cuál ítem de ese nodo
| Escribes | Obtienes |
|---|---|
.item | El ítem enlazado con el que se está procesando |
.first() | El primer ítem que entregó ese nodo |
.last() | El último |
.all() | Todos, como lista |
En nueve de cada diez casos quieres .item. Usa .first() cuando el nodo entregó un solo dato general, como un ajuste o un total.
12
Qué significa «ítem enlazado»
n8n recuerda de qué ítem nació cada ítem. Cuando el correo del pedido 2 pide el dato de «Leer pedidos», recibe el del pedido 2 y no el de otro cliente.
Ese rastro puede perderse si en el medio un nodo junta o reagrupa ítems. Ahí conviene llevar el dato contigo en vez de ir a buscarlo atrás.
13
El nodo que no se ejecutó
Tu flujo se divide en dos caminos. Un nodo del camino A pide un dato de un nodo del camino B.
14
Ponle nombre a tus nodos
Como el nombre del nodo forma parte de la expresión, un flujo con «HTTP Request», «HTTP Request1» y «HTTP Request2» es imposible de leer.
Después de renombrar, abre los nodos que lo usaban y confirma que la vista previa sigue mostrando el valor.
15
Dentro de las llaves hay JavaScript
Las expresiones aceptan operaciones cortas de JavaScript, el lenguaje de programación de los navegadores. No necesitas aprenderlo: con cuatro formas resuelves la mayoría.
| Quieres | Escribes |
|---|---|
| Sumar | {{ $json.total + 1500 }} |
| Mayúsculas | {{ $json.cliente.toUpperCase() }} |
| Elegir entre dos textos | {{ $json.pagado ? 'Pagado' : 'Pendiente' }} |
| Valor de respaldo | {{ $json.telefono ?? 'Sin teléfono' }} |
16
La fecha y hora de ahora
Dos variables están siempre disponibles, sin depender de ningún nodo:
{{ $now }}: la fecha y hora de este momento.{{ $today }}: el día de hoy a medianoche.
Sirven para timbrar un registro, nombrar un archivo o calcular un vencimiento. Usan la zona horaria de n8n, que hay que dejar bien configurada. Eso y el formato de fechas son la clase 4.
17
El límite de una expresión
Si la expresión no cabe en una línea que puedas leer en voz alta, ya no es trabajo para una expresión.
18
Expresión, nodo o código
| Necesidad | Herramienta |
|---|---|
| Usar o retocar un valor dentro de un campo | Expresión |
| Filtrar, ordenar, agrupar o quitar duplicados | Nodos de datos (clase 3) |
| Lógica larga o reestructurar todo | Nodo Code (clase 5) |
Lo bueno de la expresión: no agrega nodos y ves el resultado al instante. Lo malo: queda escondida dentro de un campo. Quien abra el flujo no la ve en el lienzo.
19
Síntomas y causas
| Ves esto | Suele ser |
|---|---|
undefined | Nombre de campo mal escrito o que no existe en ese ítem |
[object Object] | Apuntaste a un objeto; falta el campo interior |
El texto {{ ... }} tal cual | El campo quedó como valor fijo |
| El mismo valor en todos los ítems | Usaste .first() donde iba .item |
20
Si el campo quedó como valor fijo
Cada parámetro tiene dos modos: fijo y expresión. Al arrastrar un campo, n8n pasa solo al modo expresión.
Si escribes a mano y las llaves quedan como texto, pasa el cursor sobre el parámetro, busca su selector de modo y cámbialo a expresión.
21
Pedirle una expresión a Claude
Claude escribe bien expresiones si ve los datos. Dale tres cosas:
- Una muestra copiada de la vista JSON, con datos ficticios.
- El resultado exacto que quieres para esa muestra.
- Que es una expresión de n8n, de una sola línea.
22
Lo que te llevas
- Una expresión va entre
{{ }}y se calcula una vez por ítem. $jsones el ítem actual;$('Nombre').item.jsontrae datos de un nodo anterior.- Arrastrar el campo es más seguro que escribir.
- La vista previa bajo el campo te dice si quedó bien.
- Si no cabe en una línea, pasa a un nodo de datos o al nodo Code.
23
Hazlo ahora
Diez minutos en un flujo de prueba.
- Agrega un disparador manual y un nodo Edit Fields (Set). Crea dos campos fijos:
clienteytotal. - Agrega un segundo Edit Fields y arrastra
clientea un campo nuevo llamadosaludo. - Edita el valor para que diga «Hola» antes del nombre.
- Crea otro campo con
totalmás 1500. - Rompe a propósito un nombre de campo y mira qué muestra la vista previa.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Expressions versus data nodes (documentación de n8n)docs.n8n.io ↗
- Reference previous nodes (documentación de n8n)docs.n8n.io ↗
- Reference data (documentación de n8n)docs.n8n.io ↗
- Understand n8n's data structure (documentación de n8n)docs.n8n.io ↗
- Work with dates and times (documentación de n8n)docs.n8n.io ↗