Switch no n8n: como dividir o fluxo em vários caminhos

Aprenda a usar o Switch no n8n: quando preferir ao IF, como montar regras e expressões, o que fazer com itens sem regra e como enviar para várias saídas.

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

O Switch no n8n é o nó que divide o fluxo em vários caminhos: cada item que chega vai para uma saída diferente, conforme regras que você define. Ele é parecido com o IF, mas aceita mais de duas saídas.

Neste guia você vê quando usar o Switch no lugar do IF, como montar as regras no modo Rules, como usar o modo Expression, o que fazer com itens que não casam com nenhuma regra e um exemplo prático com status de pedido. A base é a documentação do n8n sobre os nós Switch e If.

Switch ou IF: qual usar

A documentação do n8n descreve o Switch como um nó parecido com o IF, mas com suporte a várias rotas de saída. O IF tem duas saídas, true e false. A própria documentação do IF indica o Switch para quando você precisa de mais de duas saídas condicionais.

O IF trabalha com tipos de condição como String, Number, Date & Time, Boolean, Array e Object, e combina várias condições com AND (todas precisam ser verdadeiras) ou OR (pelo menos uma precisa ser verdadeira). Para um fluxo que só decide entre "sim" e "não", o IF resolve. Veja como montar em IF no n8n: como criar condições no seu fluxo.

Quando o fluxo tem três ou mais caminhos, por exemplo pedidos com status "pago", "pendente" e "cancelado", um Switch substitui vários IFs encadeados e deixa o desenho do fluxo mais fácil de ler.

Switch no modo Rules, passo a passo

O nó tem o campo Mode com duas opções: Rules e Expression. No modo Rules você cria uma regra de roteamento (Routing Rules) para cada saída. Para montar:

1. Adicione o nó Switch depois do nó que entrega os itens, como um Webhook ou uma planilha.
2. Em Mode, escolha Rules.
3. Crie a primeira regra. Escolha o tipo de dado (texto, número, data e assim por diante) e a comparação no menu de tipo.
4. Informe o valor que vem do item, arrastando o campo do painel de entrada ou escrevendo a expressão, e o valor de comparação.
5. Adicione uma regra para cada caminho que você quer. Cada regra vira uma saída do nó.
6. Ligue cada saída ao nó que deve continuar aquele caminho.
7. Execute o nó com dados de teste e confira por qual saída cada item saiu.

Por padrão as saídas aparecem numeradas, 0, 1, 2. Para deixar o fluxo legível, use o recurso Rename Output: ele liga um nome à saída, no campo Output Name. Uma saída chamada "Pago" diz mais do que uma chamada "0".

Para ler o valor do item dentro da regra, use uma expressão como esta:

{{ $json.status }}

Switch no modo Expression

No modo Expression você escreve uma expressão que devolve o número da saída. Dois campos mandam aqui: Number of Outputs, que diz quantas saídas o nó tem, e Output Index, onde fica a expressão. Segundo a documentação, a expressão precisa devolver um número.

Um exemplo com duas saídas (Number of Outputs igual a 2):

{{ $json.prioridade === 'alta' ? 0 : 1 }}

Aqui, itens com prioridade alta saem pela saída 0 e os outros pela saída 1. Para mais saídas, aumente o Number of Outputs e devolva 2, 3 e assim por diante.

Se a lógica é mais complexa do que uma expressão curta comporta, o nó Code pode calcular o valor antes do Switch.

Veja o preço: o n8n Essencial está a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

Fallback: o que fazer quando nada combina

Nem todo item cai em uma das suas regras. A opção Fallback Output define o destino desses itens:

• None: o item é ignorado. É o padrão, o que significa que um item que não casa some do fluxo sem aviso.
• Extra Output: cria uma saída a mais, só para os itens que não casaram com regra nenhuma.
• Output 0: manda o item para a mesma saída da primeira regra.

Em fluxos de produção, vale ligar o Extra Output e levar essa saída a um alerta, uma planilha de erros ou uma anotação. Assim, um status novo que não estava nas regras não desaparece em silêncio. Para tratar falhas do próprio fluxo, veja também Tratar erros no n8n: Error Trigger e alertas no fluxo.

Enviar para todas as saídas que combinam

Sem ligar a opção descrita abaixo, o item vai só para a primeira saída cuja regra bate. Se duas regras podem ser verdadeiras para o mesmo item, a segunda não recebe nada.

A opção Send data to all matching outputs muda esse comportamento. Com ela ligada, o item vai para todas as saídas cujas regras batem; desligada, só para a primeira. Um caso de uso: um pedido de valor alto e de cliente novo, que deve seguir ao mesmo tempo para a conferência e para o envio de boas-vindas.

Outras duas opções ajudam na comparação:

• Ignore Case: ligada, ignora a diferença entre maiúscula e minúscula.
• Less Strict Type Validation: ligada, o n8n tenta converter o tipo do valor conforme o operador, por exemplo tratar o texto "10" como número.

Exemplo prático: pedidos por status

Imagine um fluxo que recebe pedidos e precisa tomar um caminho para cada status. Cada item chega com um campo status. O Switch fica assim:

1. No modo Rules, crie três regras, comparando {{ $json.status }} com o texto "pago", "pendente" e "cancelado".
2. Use o Rename Output para chamar as saídas de "Pago", "Pendente" e "Cancelado".
3. Em Fallback Output, escolha Extra Output para pegar o status que não esteja na lista.
4. Na saída "Pago", ligue o nó que registra o pedido, por exemplo numa planilha.
5. Na saída "Pendente", ligue um nó de espera ou de lembrete.
6. Na saída "Cancelado", ligue um aviso por e-mail; veja Enviar e-mail no n8n: como usar o nó Send Email.
7. Na saída extra, ligue um alerta para você investigar o status inesperado.

Teste o fluxo com um item de cada status e com um status inventado. O item inventado deve sair pela saída extra. Se ele sumir, o Fallback Output provavelmente está em None.

Erros comuns no Switch

• Tipo de dado errado. Comparar o número 10 com o texto "10" pode dar resultado diferente do esperado. Escolha o tipo de dado adequado na regra, ou ligue o Less Strict Type Validation e confira o resultado.
• Maiúsculas e minúsculas. "Pago" e "pago" são textos diferentes numa comparação exata. Ligue o Ignore Case ou padronize o valor antes.
• Itens que somem. Com o Fallback Output em None, o item que não casa é ignorado. Troque por Extra Output quando não puder perder itens.
• Regras que se sobrepõem. Com a opção de enviar para todas as saídas desligada, só a primeira regra verdadeira recebe o item. Confira a ordem das regras.
• Expressão que não devolve número. No modo Expression, o resultado precisa ser um número de saída que exista. Confira o Number of Outputs.
• Chaves da expressão quebradas. Uma expressão como {{ $json.status }} precisa estar com as chaves duplas inteiras para o n8n calcular o valor.

Quando um passo posterior depende da lista inteira, outro nó pode ajudar. Para repetir ações item a item, veja Loop no n8n: como usar o Loop Over Items no fluxo.

Conheça o plano: o n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n

Perguntas frequentes

Qual a diferença entre o Switch e o IF no n8n?

O IF tem duas saídas, true e false. O Switch tem várias saídas e manda cada item para a rota cuja regra bate. A documentação do n8n indica o Switch quando você precisa de mais de duas saídas condicionais.

O que acontece com o item que não combina com nenhuma regra?

Depende do Fallback Output. Em None, o item é ignorado. Em Extra Output, vai para uma saída a mais. Em Output 0, vai para a saída da primeira regra.

Posso mandar o mesmo item para duas saídas?

Sim, ligando a opção Send data to all matching outputs. Com ela desligada, o item vai só para a primeira saída que bate.

Como o Switch lida com maiúsculas e minúsculas?

Com a opção Ignore Case ligada, a diferença entre maiúscula e minúscula é ignorada nas comparações.