← voltar Janela de navegador com arte linear, um formulário simples e uma seta apontando para um envelope aberto em uma bandeja

Netlify Forms em 2026: Configuração, Filtros de Spam e Limites

Comparativos de ferramentas e serviços

Netlify Forms funciona lendo seu HTML compilado no momento do deploy. Ative a detecção de formulários, adicione um atributo netlify ou data-netlify="true" à tag form, dê um nome único ao formulário e faça o redeploy. Isso é o suficiente para um site HTML simples. Astro, Next.js e qualquer coisa renderizada por JavaScript precisam de uma cópia HTML estática do formulário, porque a compilação nunca vê o verdadeiro. Abaixo: configuração para cada caso, filtragem Akismet mais honeypots e reCAPTCHA, notificações, o que as próprias páginas da Netlify dizem sobre limites, uma tabela de solução de problemas e quando outro backend é a melhor opção.

Como Netlify Forms funciona

Não há endpoint de formulário para compilar. Quando um deploy é concluído, o sistema de compilação da Netlify analisa o HTML que está prestes a publicar. Conforme a documentação de configuração do Netlify Forms, é por isso que a página não precisa de nenhuma chamada de API e nenhum JavaScript extra.

Três coisas precisam ser verdadeiras:

  • A detecção de formulários está ativada para o site (na interface da Netlify, vá para Forms e selecione Enable form detection). Ela se aplica a partir do seu próximo deploy.
  • A tag form tem data-netlify="true" ou um atributo netlify simples.
  • O formulário tem um nome e nenhum outro formulário no site compartilha dele.

Durante a análise, a compilação remove o atributo data-netlify ou netlify e injeta um input oculto chamado form-name, com um valor correspondente ao nome do seu formulário. Os envios aparecem então na seção Forms da interface da Netlify. Tudo que o Akismet aprova vai para Verified submissions; tudo que ele marca vai para Spam submissions.

Uma pegadinha que vale a pena saber cedo: se você desativou a detecção uma vez, reativá-la em Forms, depois Form detection, não faz nada até você fazer um redeploy. A mesma documentação observa que desativar a detecção reduz o pós-processamento e pode acelerar deploys, o que é uma razão justa para desativar em um site que não tem mais formulários.

Configuração para HTML simples, Astro e Next.js

HTML simples

Aqui está a lista de verificação que eu usaria para um site estático:

  1. Na interface da Netlify, abra Forms e selecione Enable form detection.
  2. Adicione data-netlify="true" ou netlify à tag form.
  3. Defina um name único no formulário e um name distinto em cada input.
  4. Faça o deploy. Se a detecção já estava ativada e você apenas adicionou o formulário, um deploy normal é o suficiente; se você acabou de ativá-la, faça um redeploy.
  5. Envie uma entrada de teste realista e procure em Verified submissions, depois Spam submissions.

O próprio exemplo da documentação é um formulário de contato com method="POST", name, email, um multi-select e uma mensagem. Nada exótico e nada mais do que o padrão exige.

Se você preferir enviar com fetch, o body deve ser codificado por URL. A documentação o constrói com new URLSearchParams(formData).toString() e o header application/x-www-form-urlencoded. Netlify Forms não oferece suporte a dados de formulário JSON no momento, então JSON.stringify é um beco sem saída. Para uploads de arquivos, a documentação recomenda omitir o header Content-Type.

Astro

O template Astro da Netlify coloca o atributo netlify direto na tag form e adiciona netlify-honeypot para bloqueio de spam. Essa é a versão simples e um bom lugar para começar.

Mas o artigo da Base de Conhecimento da Netlify (datado de 27 de agosto de 2026) lista Astro junto com Next.js, Nuxt, SvelteKit e Gatsby como frameworks cujos formulários "não estão no HTML compilado, então a análise em tempo de deploy nunca os vê". Sua solução é manter uma cópia oculta de cada formulário em public/__forms.html, com nomes de campo correspondendo exatamente. Se seu formulário Astro nunca aparecer na interface, adicione esse arquivo esqueleto e faça o redeploy.

Next.js

É aqui que a maioria das pessoas perde uma tarde. A documentação do OpenNext para Netlify explica que páginas modernas do Next.js são pré-renderizadas e cacheadas em vez de escritas como arquivos HTML estáticos. Atributos netlify ou data-netlify no seu código React não têm efeito, portanto, a URL de destino do formulário deve ser um arquivo estático.

O contorno, consistentemente nas páginas da Netlify:

  • Coloque um arquivo HTML estático em public que defina o formulário e todos os campos, com nomes correspondentes ao seu formulário React.
  • Envie com AJAX para esse destino estático em vez de uma navegação de página completa (as dicas de solução de problemas dizem que o Next.js Runtime v5 precisa de definições de formulário em um arquivo HTML estático dedicado e envio via AJAX).
  • Inclua o input form-name oculto no seu formulário React.

O OpenNext também menciona que a verificação de formulário do adaptador pode ser ignorada definindo NETLIFY_NEXT_VERIFY_FORMS como false. Para Next.js 13.5 e superior, a documentação de configuração aponta para as mudanças significativas da v5 do runtime.

Qualquer formulário renderizado por JavaScript

Mesma ideia em todos os lugares. O build "não a encontrará nos arquivos pré-construídos", então crie um formulário HTML oculto com atributos name correspondentes e adicione um input form-name oculto ao formulário JS. Quer reCAPTCHA 2 também? O HTML oculto também precisa de uma div com data-netlify-recaptcha="true".

Uma ressalva honesta: o exemplo AJAX da documentação de configuração faz POST para /, enquanto o exemplo da Base de Conhecimento faz POST para /__forms.html e diz que sites estáticos podem fazer POST para / mas SSR deve apontar para o arquivo skeleton. Se um POST para / retornar 404 em um site SSR, tente o caminho skeleton.

Spam: honeypots, reCAPTCHA e Akismet

Cada envio passa pelo Akismet, conforme a documentação de filtro de spam. Você recebe isso sem configuração. Os extras são opcionais, e se comportam de forma diferente.

Peneira de arte linear capturando pequenos bots em forma de bug enquanto envelopes passam, ao lado de um formulário com um campo oculto tracejado

Honeypot

Adicione netlify-honeypot="bot-field" (ou qualquer nome) à tag form, depois inclua um input com esse nome e o oculte com CSS ou JavaScript. O build remove o atributo e deixa o input. Se um bot o preencher, a Netlify rejeita silenciosamente o envio.

Dois detalhes prejudicam. Oculte com CSS em vez de tratar type="hidden" como suficiente, porque a ideia é um campo que um bot vê e um humano não. Com AJAX, o nome do campo honeypot tem que estar no corpo POST, o que acontece automaticamente se você codificar com FormData(). O FAQ de solução de problemas adiciona que um honeypot omitido do envio, ou preenchido, é rejeitado silenciosamente. Corpos de requisição construídos manualmente que ignoram o campo desaparecerão.

reCAPTCHA 2

Netlify pode fornecer um: adicione data-netlify-recaptcha="true" à tag form e a uma div vazia onde o desafio deve aparecer. A validação é do lado do servidor, e uma falha redireciona o visitante de volta para a mesma página e rejeita o envio. Você recebe um desafio fornecido pela Netlify por página.

Precisa de mais de um, ou quer controle? Use reCAPTCHA 2 customizado. Defina SITE_RECAPTCHA_KEY (o escopo deve incluir Builds e Runtime) e SITE_RECAPTCHA_SECRET (o escopo deve incluir Runtime), e Netlify aceita apenas envios com uma g-recaptcha-response válida.

O que vai para onde

Aqui está a parte que as pessoas perdem. Envios capturados por um honeypot ou reCAPTCHA 2 são rejeitados totalmente e nunca chegam à sua lista de envios de spam. Se uma pessoa real relata uma falha no envio, você não consegue extraí-la dessa aba. As capturas do Akismet, em contraste, são mantidas para revisão.

Notificações e integrações

Notificações ficam em Forms, depois Submission notifications. A documentação de configuração descreve duas rotas: enviar o conteúdo do envio para um endereço de email, ou enviá-lo para um serviço externo com uma requisição HTTP POST.

A segunda rota é a mais flexível. Aponte para um webhook e você pode alimentar o Slack, um CRM ou seu próprio endpoint. Uma comparação de terceiros do Static Forms lista as integrações do Netlify Forms como email, webhooks e Slack, o que corresponde a esse quadro. É uma página de um concorrente, então leia como um resumo, não como uma especificação.

Uma pequena dica da Base de Conhecimento: inclua um <input name="email"> e o email de notificação Reply-to é definido para o remetente. Clicar em responder então vai para o visitante em vez de para a Netlify.

Se seu formulário recebe uploads, lembre dos limites: um arquivo por campo, tamanho máximo de requisição de formulário de 8 MB e timeout de 30 segundos. Se esses arquivos contêm dados pessoais, a Netlify diz que você precisa de configuração de segurança extra e recomenda sua integração Very Good Security.

Limites e preços

Resumido: consulte as páginas da Netlify no dia em que decidir, porque atualmente elas não dizem exatamente a mesma coisa.

A página de preços lista Gratuito a $0 para sempre com limite de 300 créditos por mês, Pessoal a $9 por mês com 1.000 créditos e Pro a $20 por mês com membros ilimitados, começando com 3.000 créditos e chegando a 20.000 em camadas. Descreve os créditos inclusos como cobrindo deploys de produção, computação, envios de formulários, largura de banda e requisições web. Seu FAQ adiciona que contas criadas antes de 4 de setembro de 2025 podem manter seu plano atual.

O documento de uso e cobrança de Formulários diz que em planos baseados em créditos, Formulários são gratuitos e ilimitados. Uma página lista envios de formulários entre as coisas que os créditos cobrem, enquanto a outra diz que Formulários não custam nada nesses planos. Textos de terceiros também divergem: uma análise do splitforms.com diz que os envios não custam créditos desde 14 de abril de 2026, enquanto uma comparação Submit JSON diz que consomem créditos. Eu confiaria no documento de cobrança da Netlify em relação a qualquer um deles, depois confirme no seu próprio painel.

Em planos legados, o documento diz que o uso de Formulários rastreia Envios (envios verificados por período de cobrança) e Uploads de arquivo (armazenamento total), medidos por site. Em um limite de nível, o site se move automaticamente para o próximo nível ou pacote, e contas de camada gratuita também são medidas com um limite. O único número que vi para esse limite, 100 envios por site por mês, vem da análise do splitforms.com, não das páginas da Netlify. Verifique antes de depender dele.

Nem a página de preços nem o documento de cobrança trazem uma data, então abra os dois quando ler isto.

Tabela de solução de problemas

As correções abaixo vêm do FAQ de solução de problemas da Netlify (datado de 3 de outubro de 2026) e dicas de solução de problemas de formulários (datado de 16 de setembro de 2026), mais os documentos de configuração.

SintomaCausaSolução
Formulário nunca aparece na interface da NetlifyRenderizado no lado do cliente, ou detecção desativadaAdicione uma cópia HTML estática com nomes correspondentes; ative a detecção e faça redeploy
Um novo campo está faltando nos enviosCampo não está na versão HTML estáticaAdicione o campo ao formulário estático e faça redeploy
Nada acontece após ativar a detecçãoSó se aplica a novos deploysFaça redeploy do site
Entradas de teste não estão em Envios verificadosAkismet as sinalizouVerifique Envios de spam; use um email real, sentenças completas e espaçe os testes
Envios desaparecem com honeypotCampo honeypot omitido ou preenchidoInclua o campo no corpo do POST; use FormData()
Envio AJAX falha ou é ignoradoCorpo enviado como JSONURL-encode do corpo
Atributos Next.js não fazem nadaPáginas não são arquivos HTML estáticosArquivo de formulário estático em public, enviar via AJAX
Dados antigos desaparecem após renomear um campoUI mostra apenas campos atuaisUse o endpoint listFormSubmissions da API; oculte campos antigos em vez de removê-los

Se o formulário não faz nada silenciosamente, trabalhe as três primeiras linhas em ordem. É a maioria dos casos.

Quando um backend diferente se encaixa melhor

Netlify Forms é uma boa padrão quando você já está no Netlify e precisa de um formulário de contato. Nem sempre é o ideal.

Mantendo WordPress

Se seu site é WordPress e o formulário já funciona, raramente há motivo para movê-lo. Contact Form 7, WPForms e plugins similares rodam no seu próprio servidor, mantêm dados no seu próprio banco de dados e ficam dentro do editor que seu time já conhece. Se e-mails não estão chegando, é um problema de entrega que você pode corrigir onde está: veja por que Contact Form 7 para de enviar e-mail. Mover um formulário para Netlify só faz sentido se todo o site também estiver migrando para uma construção estática. Essa é uma decisão de hospedagem, e Vercel versus Netlify é um lugar razoável para pesar isso.

Formspree e backends de formulário similares

Um backend de formulário hospedado faz sentido se seu site não for implantado através da build do Netlify. Netlify Forms depende de detecção em tempo de deploy, então só funciona para sites implantados lá. Um serviço de formulário oferece um endpoint que funciona de qualquer host. A comparação do Static Forms, por exemplo, lista um nível gratuito de 250 envios a cada 30 dias, sua própria figura, em sua própria página. Formspree funciona no mesmo princípio, embora eu não esteja citando seus limites aqui. Verifique sua página de preços.

Uma função serverless

Se você precisa validar contra um banco de dados, enviar um e-mail personalizado ou chamar outra API, uma função oferece controle total e o custo é código que você mantém. O template Astro do Netlify aponta para funções acionadas por formulário em seus recursos, o que oferece um caminho intermediário: mantenha Netlify Forms para armazenamento e spam, e execute código por envio.

Um formulário CMS ou builder

Se editores precisam alterar campos sem tocar no código, um formulário integrado no CMS ou page builder vence. Arquivos blueprint HTML estáticos são o oposto de amigáveis ao editor.

FAQ

Posso usar Netlify Forms em um site hospedado em outro lugar?

Não da forma que você esperaria. A detecção acontece na build do Netlify, então o formulário precisa estar em um deploy do Netlify. Uma revisão de terceiros diz o mesmo: formulários funcionam em sites implantados no Netlify.

Por que as respostas vão para o endereço errado?

Adicione um <input name="email"> ao formulário. A Base de Conhecimento diz que isso define o Reply-to do e-mail de notificação para o remetente.

Devo desativar a detecção de formulário se remover meus formulários?

É razoável. O Netlify diz que desabilitá-lo reduz pós-processamento e pode acelerar deploys. Você confirma inserindo o nome do site, e entra em efeito no próximo deploy.

Posso coletar arquivos que incluem dados pessoais?

O Netlify diz que formulários com uploads contendo PII precisam de configuração de segurança extra e recomenda a integração Very Good Security. Lembre-se também dos limites de um arquivo por campo e requisições de 8 MB.

A ressalva mais importante: o Netlify só vê formulários que existem como HTML estático no momento do deploy, então qualquer formulário renderizado por framework precisa de uma cópia estática com nomes de campo correspondentes. Se você está considerando uma mudança para um stack estático e quer uma segunda opinião sobre a build, serviços de desenvolvimento Jamstack cobrem esse tipo de trabalho.

← voltar