Edit Fields no n8n: como criar e mudar campos no fluxo

Aprenda a usar o nó Edit Fields do n8n: Manual Mapping, JSON Output, valor fixo ou expressão, Keep Only Set Fields e notação de ponto, com exemplos.

Por Redação Eleven Host · @robson.direitodigital · 29 de outubro de 2026 · 8 min de leitura

Edit Fields no n8n é o nó (também chamado Set) que cria, muda e organiza os campos dos dados que passam pelo fluxo. Segundo a documentação do n8n, ele tem dois modos: Manual Mapping, para editar pela interface, e JSON Output, para escrever o JSON.

Este guia explica cada modo, as opções do nó e dois exemplos de uso, em português simples. Os fatos vêm da página do nó Edit Fields (Set) na documentação do n8n. Os nomes e valores dos exemplos são fictícios.

Para que serve o nó Edit Fields

Num fluxo do n8n, cada nó recebe dados do nó anterior e entrega dados ao próximo. O Edit Fields fica no meio e mexe nesses dados: você escolhe quais campos existem, como se chamam e que valores têm.

Com ele, você pode, por exemplo:

• criar um campo novo com um valor fixo;
• copiar um valor de um campo para outro, com outro nome;
• descartar os campos que você não quer levar adiante;
• montar um bloco de dados do jeito que uma etapa seguinte espera.

Para ver outro nó que trabalha com dados de entrada e saída, leia Merge no n8n: como juntar dados de vários caminhos.

Os dois modos do Edit Fields

A documentação do n8n descreve dois modos de trabalho. Você escolhe um deles no próprio nó:

• Manual Mapping: você edita os campos pela interface do n8n, sem escrever código.
• JSON Output: você escreve um JSON, e o n8n o adiciona aos dados de entrada ("write JSON that n8n adds to the input data", nas palavras da documentação).

Quem está começando costuma achar o Manual Mapping mais fácil. O JSON Output serve a quem já sabe o formato JSON e quer montar uma estrutura inteira de uma vez.

Manual Mapping: passo a passo

No Manual Mapping, a seção principal chama-se Fields to Set. Veja como ela funciona, segundo a documentação:

1. Arraste valores do Input: o painel Input mostra os dados que chegam ao nó. Você arrasta e solta um valor dali para a área de campos.
2. O nome vem do valor: por padrão, o nome do valor arrastado vira o nome do campo.
3. O valor vira uma expressão: também por padrão, o valor do campo passa a ser uma expressão que acessa o dado de origem.
4. Para um valor fixo, troque o seletor: passe o mouse sobre o campo e escolha "Fixed" no seletor Fixed | Expression. Isso vale para o nome e para o valor.

Exemplo 1: guardar o nome do cliente

Imagine que um nó anterior entrega itens com um campo de nome. No Fields to Set, você arrasta esse campo do Input. O nó cria um campo com o mesmo nome e uma expressão ligada ao dado de origem. Se quiser mudar o nome do campo, edite o nome e deixe a expressão do valor como está.

Exemplo 2: criar um campo fixo

Para marcar todos os itens com uma origem, crie um campo novo, passe o mouse e escolha "Fixed" no valor. Digite, por exemplo, origem como nome e site como valor. Todo item que sair do nó leva esse campo, sempre com o mesmo texto.

Keep Only Set Fields e Include in Output

Duas opções controlam o que sai do nó, além dos campos que você criou:

• Keep Only Set Fields: descarta os dados de entrada que você não usou no Fields to Set. Sobram só os campos que você montou.
• Include in Output: permite escolher quais dados de entrada entram na saída.

Ligue o Keep Only Set Fields quando quiser uma saída enxuta, só com os campos que você montou. O resultado de cada combinação das duas opções pode surpreender, então teste e olhe a saída do nó.

Opções extras do nó

A documentação lista opções que você pode adicionar ao nó:

• Include Binary Data: decide se os dados binários, como arquivos, vão para a saída.
• Ignore Type Conversion Errors: existe só no Manual Mapping e faz o nó ignorar alguns erros de tipo ao mapear os campos.
• Support Dot Notation: vem ligada por padrão e muda como o nó trata nomes com ponto.

Support Dot Notation: o ponto no nome do campo

Com a opção ligada, o ponto no nome cria um objeto dentro de outro. O exemplo da documentação: um campo chamado number.one com valor 20 vira:

{ "number": { "one": 20 } }

Com a opção desligada, o nome fica inteiro, com o ponto, e o resultado é:

{ "number.one": 20 }

Desligue a opção se os seus dados já têm nomes com ponto e você quer mantê-los como estão.

Quer rodar seus fluxos de n8n num servidor, sem depender do seu computador? Veja o n8n Essencial a partir de R$ 19,90/mês e confira na loja o que cada plano inclui. Ver o n8n

JSON Output: escrevendo o JSON

No modo JSON Output, você escreve o JSON que o n8n vai adicionar aos dados de entrada. A documentação informa que o campo aceita arrays e expressões. Dois exemplos dela mostram uma diferença importante entre pôr a expressão entre aspas ou fora delas:

• "innerKey2": "{{ $json.id }}" vira um texto. No exemplo da documentação, o resultado é "23423532", entre aspas.
• [{{ $json.id }}], dentro de um array e sem aspas, vira um número: 23423532.

Em outras palavras, a expressão entre aspas entrega texto, e a expressão sem aspas, dentro de um array, entrega número. Confira sempre o tipo que o próximo nó espera.

Quando escolher o JSON Output

Escolha o JSON Output quando o formato de saída for grande ou tiver vários níveis. Montar uma estrutura aninhada arrastando campos um a um dá mais trabalho do que escrevê-la de uma vez. Para ajustes simples, como renomear dois campos, o Manual Mapping basta.

Erros comuns e como evitar

• Campo some na saída: confira se o Keep Only Set Fields está ligado. Com ele, tudo que você não pôs no Fields to Set é descartado.
• Valor muda quando deveria ser fixo: o campo está como Expression. Passe o mouse e troque para Fixed.
• Nome com ponto vira objeto: é o Support Dot Notation ligado. Desligue a opção para manter o nome inteiro.
• Número virou texto: no JSON Output, a expressão entre aspas devolve texto. Tire as aspas dentro de um array, como no exemplo da documentação.
• Erro de tipo ao mapear: no Manual Mapping, a opção Ignore Type Conversion Errors ignora alguns erros, mas a documentação não detalha quais. Use com cuidado e confira a saída.

Se o fluxo parar por causa de um erro, o guia Tratar erros no n8n: Error Trigger e alertas no fluxo mostra como receber um aviso.

O Edit Fields com outros nós

O Edit Fields trabalha bem como ponte entre dois nós. Depois de dividir o fluxo em caminhos com o Switch, ele pode ajustar os campos de cada caminho, e o guia Switch no n8n: como dividir o fluxo em vários caminhos mostra como criar essas ramificações. Para tarefas que exigem lógica própria, o nó Code serve melhor, e o guia Code no n8n: como usar JavaScript no seu fluxo explica como usá-lo. A escolha entre os dois nós depende do que você precisa fazer.

Precisa de um n8n em servidor para os seus fluxos? Compare os planos de n8n da Eleven Host a partir de R$ 19,90/mês e confira na loja o que cada plano inclui. Escolher meu n8n

Perguntas frequentes

Edit Fields e Set são o mesmo nó?

Sim. Segundo a documentação do n8n, o nome é Edit Fields (Set), e a página dele na documentação usa o endereço n8n-nodes-base.set.

Como colocar um valor fixo em um campo?

No Manual Mapping, passe o mouse sobre o campo e escolha "Fixed" no seletor Fixed | Expression. Isso vale para o nome e para o valor.

Como manter só os campos que eu criei?

Ligue a opção Keep Only Set Fields. Ela descarta os dados de entrada que você não usou em Fields to Set.

Por que o campo number.one virou um objeto?

Porque o Support Dot Notation vem ligado por padrão. Com ele, o ponto cria um objeto dentro de outro. Desligado, o nome fica como number.one.

O JSON Output aceita expressões?

Aceita, e também arrays. A expressão entre aspas devolve texto, e a expressão sem aspas, dentro de um array, devolve número, segundo os exemplos da documentação.