Remove Duplicates no n8n: como tirar itens repetidos

Entenda o nó Remove Duplicates do n8n: as três operações, a comparação de campos, o histórico entre execuções, o escopo e um exemplo prático com pedidos de uma API.

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

O nó Remove Duplicates no n8n tira itens repetidos do fluxo, comparando os campos que você escolher. Ele também pode comparar a entrada atual com itens de execuções anteriores.

Neste guia você vê quando usar o nó, as três operações com os nomes exatos, como escolher os campos da comparação, como o histórico entre execuções funciona e um exemplo prático com uma lista de uma API.

Quando usar o Remove Duplicates

Um caso é a lista que vem de uma API com itens repetidos. O guia HTTP Request no n8n: como chamar uma API no fluxo mostra como fazer a chamada. Se a resposta trouxer o mesmo item mais de uma vez, o Remove Duplicates pode tirar os repetidos.

Outro caso é o fluxo que roda em horários marcados. O guia Agendar fluxo no n8n: como usar o Schedule Trigger explica como agendar. Se o fluxo não pode processar o mesmo item duas vezes, veja a operação que compara a entrada atual com execuções anteriores.

Sobre a versão: a página oficial avisa que o nó foi reformulado na versão 1.64.0, e as versões anteriores usam outra versão da documentação. Segundo as notas de versão, o n8n 1.64.0 saiu em 16 de outubro de 2024 e trouxe duas operações novas, Remove Items Processed in Previous Executions e Clear Deduplication History. A deduplicação passou a funcionar dentro e entre execuções do workflow. O nó já existia antes, desde o n8n 1.21.0, de dezembro de 2023, para identificar e apagar itens idênticos em todos os campos ou em parte deles.

As três operações do nó

O nó tem três operações, com estes nomes na documentação:

• Remove Items Repeated Within Current Input: tira os repetidos dentro da entrada atual.
• Remove Items Processed in Previous Executions: compara a entrada atual com itens de execuções anteriores.
• Clear Deduplication History: apaga os itens guardados de execuções anteriores. Ela não mexe na entrada atual.

As duas primeiras servem para deduplicar. A terceira é de manutenção: você a usa para zerar o histórico guardado, como a página de exemplos faz entre um exemplo e outro.

Remover repetidos da entrada atual

Na operação Remove Items Repeated Within Current Input, o parâmetro Compare define o que será comparado. Ele tem três escolhas:

• All Fields: compara todos os campos do item.
• All Fields Except: compara todos, menos os campos que você informar, separados por vírgula.
• Selected Fields: compara só os campos que você informar, separados por vírgula.

Com All Fields Except ou Selected Fields, aparecem duas opções:

• Disable Dot Notation: decide se campos filhos podem ser acessados com pai.filho.
• Remove Other Fields: remove os campos que não entraram na comparação.

Um exemplo da documentação

A página de exemplos prepara os dados com um Manual Trigger, um nó Code que devolve uma lista chamada data com pessoas repetidas e um nó Split Out sobre o campo data, que gera um item por pessoa. O guia Split Out no n8n: como separar listas em itens explica esse nó.

Com Compare em All Fields, o n8n remove os itens que têm os mesmos dados em todos os campos, e sobram 8 itens únicos no exemplo. Ao trocar para Selected Fields com o campo job, o nó tira os itens que têm o mesmo job, e sobram 2.

Repare na diferença: a escolha dos campos muda o que o n8n considera repetido.

Quer montar os seus fluxos de automação? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

Lembrar o que já passou em execuções anteriores

Na operação Remove Items Processed in Previous Executions, o nó compara a entrada atual com o que foi guardado antes. A página da documentação avisa: os itens da entrada atual só são comparados com os itens guardados de execuções anteriores.

O parâmetro Keep Items Where tem três escolhas:

• Value Is New: fica o item cujo valor ainda não apareceu.
• Value Is Higher than Any Previous Value: fica o item cujo valor é maior que os anteriores.
• Value Is a Date Later than Any Previous Date: fica o item com data mais recente que as anteriores.

O parâmetro Value to Dedupe On é o campo usado na comparação, e o formato depende da escolha anterior: um ID único para Value Is New, um valor crescente para Value Is Higher than Any Previous Value e uma data em formato ISO para a opção de data.

Exemplos com expressões

A documentação usa expressões no campo Value to Dedupe On:

• Para Value Is New: {{ $json.name }}. Na primeira execução, tudo vai para a aba Kept. Na segunda, com um nome novo, só ele fica em Kept, e os já processados vão para Discarded.
• Para Value Is Higher than Any Previous Value: {{ $json.id }}. Fica só o item com id maior que todos os anteriores.
• Para Value Is a Date Later than Any Previous Date: {{ $json.last_updated }}. Fica só o item com data mais recente que todas as anteriores.

Escopo, histórico e limpeza

Duas opções controlam como o histórico é guardado.

• Scope: com Node, que é o padrão, o histórico é separado para este nó. Com Workflow, o histórico é compartilhado com outros nós Remove Duplicates que usam o escopo de workflow.
• History Size: aparece só com Value Is New e define quantos itens guardar. O padrão é 10.000, e o valor segue o Scope.

Para apagar o histórico, use a operação Clear Deduplication History. O parâmetro Mode tem uma única opção, Clean Database, que apaga todos os dados de deduplicação guardados. Ela também tem a opção Scope, com Node como padrão ou Workflow, e o escopo define qual histórico é limpo.

Exemplo prático: lista de pedidos de uma API

Este exemplo é nosso, montado só com as opções descritas acima, e os nomes de campo são fictícios. Imagine um fluxo agendado que chama uma API de uma loja e recebe uma lista de pedidos dentro de um campo chamado pedidos. Cada pedido tem um campo id_pedido.

1. Depois do HTTP Request, adicione o Split Out, com o campo pedidos. Cada pedido vira um item.
2. Adicione o Remove Duplicates e escolha Remove Items Repeated Within Current Input.
3. Em Compare, escolha Selected Fields e digite id_pedido. Pedidos repetidos na mesma resposta saem.
4. Para não repetir um pedido de uma execução para a outra, adicione um segundo Remove Duplicates com Remove Items Processed in Previous Executions, Keep Items Where em Value Is New e, em Value to Dedupe On, a expressão {{ $json.id_pedido }}.
5. Execute o fluxo duas vezes e confira as abas Kept e Discarded do segundo nó.

O que fazer com os itens que ficaram

• Filtrar. O guia Filter no n8n: como filtrar itens no seu fluxo mostra como montar uma condição. A página do nó Filter o descreve como filtro de itens com base em uma condição.
• Gravar numa planilha. Existe na base de conhecimento um guia sobre o n8n com Google Sheets.

Se quiser repetir o exemplo do zero, rode a operação Clear Deduplication History para limpar o histórico do nó.

Precisa de um n8n para os seus fluxos? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n Essencial

Perguntas frequentes

Para que serve o Remove Duplicates no n8n?

Ele tira itens repetidos do fluxo, comparando os campos que você escolher, e também pode comparar a entrada atual com itens de execuções anteriores.

Qual operação uso para não processar o mesmo item duas vezes?

A Remove Items Processed in Previous Executions, com Keep Items Where em Value Is New e um campo de ID único em Value to Dedupe On.

Como comparo só alguns campos?

Em Compare, escolha Selected Fields e digite os nomes dos campos separados por vírgula.

Como apago o histórico de deduplicação?

Use a operação Clear Deduplication History, com o modo Clean Database. O escopo (Node ou Workflow) define qual histórico é limpo.

Qual o tamanho padrão do histórico?

Com Value Is New, o History Size padrão é 10.000 itens.