Filter no n8n: como filtrar itens no seu fluxo

Veja o que o nó Filter faz, quando usar Filter, IF ou Switch, como montar a condição com expressão, combinar AND e OR e filtrar pedidos pagos antes de enviar e-mail.

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

O Filter no n8n é o nó que deixa passar para o próximo passo só os itens que cumprem as condições que você define e não deixa seguir os demais.

Este guia mostra o que o Filter faz, quando usar o Filter no lugar do IF ou do Switch, como montar a condição com uma expressão no formato {{ $json.campo }}, como combinar condições com AND e OR, quais são as opções do nó e um exemplo prático. Ele segue a documentação oficial do n8n sobre o nó Filter.

O que o Filter faz e quando usar

Segundo a documentação, o Filter filtra os itens por uma ou mais condições. Os itens que atendem a condição seguem para o próximo nó do fluxo. Os demais não seguem.

Um item, no n8n, é cada registro que passa de um nó para outro: uma linha de planilha, um pedido, um contato. O Filter olha um campo de cada item (por exemplo, o status) e compara com o valor que você escolheu. Quem passa na comparação continua, e quem não passa não segue para o próximo nó.

Use o Filter quando o seu objetivo for continuar só com uma parte dos itens e você não precisa fazer nada com o resto. Exemplos: enviar e-mail apenas aos pedidos pagos, gravar na planilha somente os contatos que têm e-mail preenchido, ou seguir só com valores acima de um limite.

Filter, IF ou Switch: qual usar

A documentação do nó IF descreve o uso dele como dividir o fluxo condicionalmente, com base em operações de comparação. Ele tem uma saída true e uma saída false, e o mesmo conjunto de tipos e de combinação AND e OR do Filter. O guia IF no n8n: como criar condições no seu fluxo mostra esse nó em detalhe.

Para mais de duas saídas, a documentação do IF indica o nó Switch. O guia Switch no n8n: como dividir o fluxo em vários caminhos explica como montar cada caminho.

Resumo da diferença prática, a partir da descrição de cada nó:

• Filter: segue só quem atende a condição, sem criar um ramo para os outros.
• IF: cria dois caminhos, true e false, para você tratar os dois grupos.
• Switch: cria vários caminhos, para mais de duas saídas.

Se você precisa fazer algo com os itens que não passaram, como avisar alguém ou gravar em outra lista, o IF atende melhor. Se só quer ficar com os que passam, o Filter atende, pois não cria um ramo para os demais.

Passo a passo: montar um Filter

Siga esta ordem no editor do n8n:

1. Tenha um nó que entregue os itens, como um Google Sheets ou um HTTP Request. Confira quais campos esse nó entrega.
2. Adicione o nó Filter logo depois dele e ligue os dois.
3. Nas condições, escolha o campo que será comparado. Escreva uma expressão no formato {{ $json.campo }}.
4. Escolha o tipo do dado e o operador da comparação (a lista completa está mais abaixo).
5. Digite o valor de comparação, por exemplo pago.
6. Execute o nó e confira na saída quais itens seguiram.

Expressões

A documentação de expressões do n8n usa a sintaxe de chaves duplas. Os exemplos dela são:

{{$json.city}}

{{$json.body.city}}

Neste guia, escrevemos no formato {{ $json.campo }}. O trecho depois de $json. é o nome do campo no item. Quando o dado está dentro de outro campo, como em body.city, o nome inclui o caminho com pontos.

Tipos e operadores

Cada condição trabalha com um tipo de dado, e cada tipo tem os próprios operadores. Os nomes abaixo são os da interface, em inglês:

• String (texto): exists, does not exist, is empty, is not empty, is equal to, is not equal to, contains, does not contain, starts with, does not start with, ends with, does not end with, matches regex, does not match regex.
• Number (número): exists, does not exist, is empty, is not empty, is equal to, is not equal to, is greater than, is less than, is greater than or equal to, is less than or equal to.
• Date & Time (data e hora): exists, does not exist, is empty, is not empty, is equal to, is not equal to, is after, is before, is after or equal to, is before or equal to.
• Boolean (verdadeiro ou falso): exists, does not exist, is empty, is not empty, is true, is false, is equal to, is not equal to.
• Array (lista): exists, does not exist, is empty, is not empty, contains, does not contain, length equal to, length not equal to, length greater than, length less than, length greater than or equal to, length less than or equal to.
• Object (objeto): exists, does not exist, is empty, is not empty.

Escolha o tipo que combina com o campo. Para um status em texto, use String. Para um valor em reais, use Number. Para uma data de pedido, use Date & Time.

Monte seus fluxos com filtros no n8n. n8n Essencial a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

Várias condições: AND e OR

Você pode colocar mais de uma condição no mesmo Filter e escolher como elas se combinam:

• AND: o item só passa se atender a todas as condições.
• OR: o item passa se atender a pelo menos uma das condições.

Dois nós em sequência são um contorno da limitação, não um recurso descrito na documentação. Exemplo com AND: status igual a pago e valor maior que 100. Exemplo com OR: cidade igual a Recife ou cidade igual a Salvador.

Opções do nó Filter

O nó tem duas opções, conforme a documentação:

• Ignore Case: ignora a diferença entre maiúsculas e minúsculas na comparação. Com ela ligada, Pago e pago são tratados como o mesmo texto.
• Less Strict Type Validation: faz o n8n tentar converter os tipos. A documentação indica essa opção para quando aparecer o erro wrong type:.

Antes de ligar a segunda opção, olhe o tipo do valor do campo na entrada do nó.

Exemplo prático: enviar e-mail só para pedidos pagos

Este fluxo é um exemplo montado a partir da documentação. Os nomes e valores são fictícios. A ideia: uma lista de pedidos chega ao n8n, e só os pagos recebem e-mail.

1. Comece com um nó que traga os pedidos. Pode ser uma planilha, como no guia n8n com Google Sheets: como conectar e automatizar planilhas, ou uma API.
2. Adicione o nó Filter.
3. Na condição, use o tipo String e o campo {{ $json.status }}.
4. Escolha o operador is equal to e escreva o valor pago.
5. Se a planilha mistura Pago e pago, ligue a opção Ignore Case.
6. Depois do Filter, adicione o nó de envio de e-mail. O guia Enviar e-mail no n8n: como usar o nó Send Email mostra a configuração.
7. Execute com poucos pedidos e confira se só os pagos geraram e-mail.

Para o e-mail levar o nome de cada cliente, use no texto uma expressão como {{ $json.nome }}. O n8n troca pelo valor de cada item que passou pelo Filter.

Erros comuns

• Nome do campo errado: confira se o nome na expressão é igual ao nome do campo no item, na saída do nó anterior.
• Tipo errado: se aparecer o erro wrong type:, ajuste o tipo do campo ou use a opção Less Strict Type Validation, como a documentação indica.
• Maiúsculas diferentes: Pago e pago são textos diferentes até você ligar Ignore Case.
• Filter no lugar do IF: se você precisa agir também sobre os itens que não passaram, o Filter não cria esse caminho. Troque por IF.
• AND e OR misturados: a mesma regra aceita um só tipo. Separe em dois nós.

Para montar fluxos com filtros, veja o plano que combina com você. n8n Essencial a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n

Perguntas frequentes

O que o nó Filter faz no n8n?

Filtra os itens por condição. Os que atendem seguem para o próximo nó, e os demais não seguem.

Qual a diferença entre Filter e IF?

O IF divide o fluxo em duas saídas, true e false. O Filter segue só com os itens que atendem a condição. Se você precisa tratar os dois grupos, use o IF.

Posso usar AND e OR juntos no mesmo Filter?

Não. Segundo a documentação, não dá para misturar AND e OR na mesma regra. Use dois nós Filter em sequência.

Como escrevo o campo na condição?

Com uma expressão no formato {{ $json.campo }}, trocando "campo" pelo nome do campo do item.

O que faz a opção Ignore Case?

Ignora a diferença entre maiúsculas e minúsculas na comparação de texto.