Reescreva expressões que usam $getPairedItem
Antes de começar
Trocar cada uso de $getPairedItem por uma forma de item linking suportada na v3.
- Busca pelos workflows que usam $getPairedItem.
- Instância de testes com cópia da sua instância.
No n8n 3.0, expressões que chamam $getPairedItem falham quando o node roda. O helper estava marcado como obsoleto. A troca usa o item linking padrão do n8n.
As três formas que substituem o helper
| Forma | O que devolve |
|---|---|
$('<node-name>').item |
O item daquele node ligado ao item atual |
$('<node-name>').itemMatching(<item-index>) |
O item ligado ao item de entrada na posição indicada |
$('<node-name>').pairedItem(<item-index>) |
O item pareado com a posição indicada |
Em expressões de parâmetro, .item resolve a maioria dos casos:
{{ $('Buscar cliente').item.json.email }}Em Code node que percorre a lista de entrada, use itemMatching() com o índice do item atual.
Procedimento
- Encontre os usos. Exporte os workflows pela CLI e procure o texto
$getPairedItemnos arquivos, ou use o relatório de migração. - No ambiente de testes, execute o workflow com pelo menos dois itens e guarde a saída.
- Troque cada chamada pela forma da tabela que corresponde ao uso.
- Execute de novo com a mesma entrada e compare item a item.
Teste com mais de um item
Com um item só, quase qualquer expressão parece certa. O erro de item linking aparece quando dois registros trocam de valor entre si. Monte o teste com pelo menos dois itens diferentes e confira cada um.
Confira o resultado
Com dois ou mais itens na entrada, cada expressão devolve o valor do registro correspondente, igual à saída anterior.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.