Netlify Forms funktioniert, indem es dein erstelltes HTML zum Zeitpunkt des Deployments einliest. Schalte die Formerkennung ein, füge ein netlify oder data-netlify="true" Attribut zu einem Formular-Tag hinzu, gib dem Formular einen eindeutigen Namen und deploy neu. Das reicht für eine reine HTML-Website aus. Astro, Next.js und alles, das von JavaScript gerendert wird, brauchen eine statische HTML-Kopie des Formulars, weil der Build das echte nie sieht. Unten: Setup für jeden Fall, Akismet-Filterung plus Honeypots und reCAPTCHA, Benachrichtigungen, was Netlify's eigene Seiten über Limits sagen, eine Fehlerbehebungstabelle und wann ein anderes Backend die bessere Wahl ist.
So funktioniert Netlify Forms
Es gibt keinen Formular-Endpoint zu bauen. Wenn ein Deploy fertig ist, parsed das Netlify Build-System das HTML, das es gerade veröffentlichen will. Laut Netlify Forms Setup Dokumentation braucht die Seite deswegen keinen API-Call und kein zusätzliches JavaScript.
Drei Dinge müssen wahr sein:
- Die Formerkennung ist für die Website aktiviert (in der Netlify UI gehe zu Forms und wähle Enable form detection). Sie gilt ab deinem nächsten Deploy.
- Der Formular-Tag trägt das Attribut
data-netlify="true"oder ein nacktesnetlifyAttribut. - Das Formular hat einen
Namen, und kein anderes Formular auf der Website teilt ihn.
Während des Parsing entfernt der Build das Attribut data-netlify oder netlify und injiziert ein verstecktes Input-Feld namens form-name mit einem Wert, der deinem Formularnamen entspricht. Einreichungen erscheinen dann im Bereich Forms der Netlify UI. Alles, das Akismet passiert, geht in Verified submissions; alles, das es kennzeichnet, geht in Spam submissions.
Eine Sache lohnt sich früh zu wissen: Wenn du die Erkennung einmal deaktiviert hast, hilft das Reaktivieren durch Forms, dann Form detection, nichts, bis du neu deployst. Dieselbe Dokumentation merkt an, dass das Deaktivieren der Erkennung die Nachbearbeitung reduziert und Deploys beschleunigen kann, was ein fairer Grund ist, es auf einer Website auszuschalten, die keine Formulare mehr hat.
Setup für Plain HTML, Astro und Next.js
Plain HTML
Hier ist die Checkliste, die ich für eine statische Website durcharbeiten würde:
- Öffne in der Netlify UI Forms und wähle Enable form detection.
- Füge
data-netlify="true"odernetlifyzum Formular-Tag hinzu. - Setze einen eindeutigen
nameauf das Formular und einen eigenennameauf jedes Input-Feld. - Deploy. Wenn die Erkennung bereits an war und du nur das Formular hinzugefügt hast, reicht ein normales Deploy; wenn du sie gerade eingeschaltet hast, deploy neu.
- Sende einen realistischen Test-Eintrag und schau unter Verified submissions, dann Spam submissions nach.
Das eigene Beispiel der Docs ist ein Kontaktformular mit method="POST", Name, E-Mail, einem Multi-Select und einer Nachricht. Nichts Exotisches, und nichts mehr als das Muster erfordert.
Wenn du lieber mit fetch absenden möchtest, muss der Body URL-codiert sein. Die Docs bauen es mit new URLSearchParams(formData).toString() und dem application/x-www-form-urlencoded Header. Netlify Forms unterstützt zum jetzigen Zeitpunkt keine JSON-Formulardaten, also ist JSON.stringify ein Sackgasse. Für Datei-Uploads empfehlen die Docs, den Content-Type Header zu weglassen.
Astro
Netlify's Astro-Template setzt das netlify Attribut direkt auf den Formular-Tag und fügt netlify-honeypot für Spam-Blocking hinzu. Das ist die einfache Version und ein fairer Startpunkt.
Aber der Netlify Knowledge Base Artikel (vom 27. August 2026) listet Astro neben Next.js, Nuxt, SvelteKit und Gatsby als Frameworks auf, deren Formulare "nicht im erstellten HTML sind, also deploy-time parsing sieht sie nie". Die Lösung ist, eine versteckte Kopie jedes Formulars unter public/__forms.html zu behalten, mit Feldnamen die genau übereinstimmen. Wenn dein Astro-Formular nie in der UI erscheint, füge diese Skeleton-Datei hinzu und deploy neu.
Next.js
Hier verlieren die meisten Menschen einen Nachmittag. OpenNext's Netlify-Dokumentation erklärt, dass moderne Next.js-Seiten vorgerendert und gecacht werden, anstatt als statische HTML-Dateien geschrieben zu werden. netlify oder data-netlify Attribute in deinem React-Code haben daher keine Auswirkung, und die Ziel-URL des Formulars muss eine statische Datei sein.
Die Lösung, durchgängig auf Netlify's Seiten:
- Lege eine statische HTML-Datei im
public-Ordner an, die das Formular und jedes Feld definiert, mit Namen, die deinem React-Formular entsprechen. - Sende mit AJAX an dieses statische Ziel statt mit einer Vollseiten-Navigation (die Tipps zur Fehlerbehebung sagen, dass Next.js Runtime v5 Formulardefinitionen in einer dedizierten statischen HTML-Datei und AJAX-Übermittlung benötigt).
- Füge das versteckte
form-nameInput in dein React-Formular ein.
OpenNext erwähnt auch, dass die Formularprüfung des Adapters übersprungen werden kann, indem man NETLIFY_NEXT_VERIFY_FORMS auf false setzt. Für Next.js 13.5 und höher verweist die Setup-Dokumentation auf die Breaking Changes der Runtime v5.
Beliebiges JavaScript-gerendertes Formular
Dieselbe Idee überall. Der Build "findet es in den vorgefertigten Dateien nicht", daher erstelle ein verstecktes HTML-Formular mit passenden name Attributen und füge ein verstecktes form-name Input zum JS-Formular hinzu. Möchtest du auch reCAPTCHA 2? Das versteckte HTML braucht auch ein div mit data-netlify-recaptcha="true".
Ein ehrlicher Haken: Das Setup in der Dokumentation hat ein AJAX-Beispiel, das zu / postet, während das Knowledge-Base-Beispiel zu /__forms.html postet und sagt, dass statische Seiten zu / POSTen können, aber SSR muss auf die Skeleton-Datei abzielen. Wenn ein POST zu / einen 404 auf einer SSR-Seite zurückgibt, versuche den Skeleton-Pfad.
Spam: Honeypots, reCAPTCHA und Akismet
Jede Übermittlung durchläuft Akismet, gemäß der Spam-Filter-Dokumentation. Das bekommst du ohne Konfiguration. Die Extras sind optional, und sie verhalten sich unterschiedlich.

Honeypot
Füge netlify-honeypot="bot-field" (oder einen beliebigen Namen) zum Formular-Tag hinzu, dann füge ein Input mit diesem Namen hinzu und verstecke es mit CSS oder JavaScript. Der Build entfernt das Attribut und lässt das Input. Wenn ein Bot es ausfüllt, lehnt Netlify die Übermittlung stillschweigend ab.
Zwei Details beißen. Verstecke es mit CSS statt type="hidden" als ausreichend zu behandeln, weil die Idee ein Feld ist, das ein Bot sieht und ein Mensch nicht. Mit AJAX muss der Honeypot-Feldname im POST-Body sein, was automatisch passiert, wenn du mit FormData() codierst. Die FAQ zur Fehlerbehebung fügt hinzu, dass ein Honeypot, das aus der Übermittlung weggelassen oder ausgefüllt ist, stillschweigend abgelehnt wird. Manuell erstellte Request-Bodies, die das Feld auslassen, verschwinden.
reCAPTCHA 2
Netlify kann eins bereitstellen: Füge data-netlify-recaptcha="true" zum Formular-Tag und zu einem leeren div hinzu, wo die Herausforderung erscheinen soll. Die Validierung erfolgt serverseitig, und ein Fehler leitet den Besucher zur gleichen Seite zurück und lehnt die Übermittlung ab. Du bekommst eine Netlify-bereitgestellte Herausforderung pro Seite.
Brauchst du mehr als eine, oder möchtest du Kontrolle? Verwende benutzerdefiniertes reCAPTCHA 2. Setze SITE_RECAPTCHA_KEY (Geltungsbereich muss Builds und Runtime enthalten) und SITE_RECAPTCHA_SECRET (Geltungsbereich muss Runtime enthalten), und Netlify akzeptiert nur Übermittlungen mit einer gültigen g-recaptcha-response.
Was wo landet
Hier ist der Teil, den Leute übersehen. Übermittlungen, die von einem Honeypot oder reCAPTCHA 2 gefangen werden, werden glatt abgelehnt und erreichen deine Spam-Übermittlungsliste niemals. Wenn eine echte Person einen fehlgeschlagenen Versand meldet, kannst du ihn nicht aus diesem Tab herausholen. Akismet-Fänge werden dagegen zur Überprüfung aufbewahrt.
Benachrichtigungen und Integrationen
Benachrichtigungen befinden sich unter Forms, dann Submission notifications. Die Setup-Dokumentation beschreibt zwei Wege: Sende den Übermittlungsinhalt an eine E-Mail-Adresse, oder sende ihn mit einer HTTP-POST-Anfrage an einen externen Service.
Die zweite Route ist die flexible. Richte sie auf einen Webhook aus und du kannst Slack, ein CRM oder dein eigenes Endpoint speisen. Ein Vergleich von Drittanbietern von Static Forms listet die Netlify Forms Integrationen als E-Mail, Webhooks und Slack auf, was dieses Bild entspricht. Es ist eine Seite eines Konkurrenten, also lies es als Zusammenfassung, nicht als Spezifikation.
Ein kleiner Tipp aus der Knowledge Base: Füge ein <input name="email"> hinzu und die Antwort-an-Adresse der Benachrichtigungs-E-Mail wird auf den Absender gesetzt. Wenn man dann antwortet, geht es an den Besucher statt an Netlify.
Wenn dein Formular Uploads annimmt, denke an die Limits: eine Datei pro Feld, eine maximale Größe der Formularanfrage von 8 MB und eine Zeitüberschreitung von 30 Sekunden. Wenn diese Dateien personenbezogene Daten enthalten, sagt Netlify, dass du zusätzliche Sicherheitskonfiguration brauchst, und empfiehlt seine Very Good Security Integration.
Limits und Preisgestaltung
Kurzversion: lies Netlify's Seiten an dem Tag, an dem du dich entscheidest, denn sie sagen derzeit nicht ganz dasselbe.
Die Preisseite listet Free mit $0 dauerhaft und einem Limit von 300 Credits pro Monat auf, Personal für $9 pro Monat mit 1.000 Credits und Pro für $20 pro Monat mit unbegrenzten Mitgliedern, beginnend bei 3.000 Credits und bis zu 20.000 in gestaffelten Paketen. Sie beschreibt enthaltene Credits als Abdeckung von Production Deploys, Compute, Formularübermittlungen, Bandbreite und Web-Anfragen. Die FAQ ergänzt, dass Konten, die vor dem 4. September 2025 erstellt wurden, ihren aktuellen Plan behalten können.
Das Forms-Nutzungs- und Abrechnungsdokument besagt, dass Forms bei gutschriftbasierten Plänen kostenlos und unbegrenzt sind. Eine Seite listet Formularübermittlungen unter den Dingen auf, die Credits abdecken, während die andere sagt, dass Forms bei diesen Plänen nichts kosten. Auch externe Darstellungen sind gespalten: eine Rezension von splitforms.com sagt, dass Übermittlungen seit dem 14. April 2026 keine Credits kosten, während ein Submit JSON-Vergleich sagt, dass sie Credits verbrauchen. Ich würde Netlify's Abrechnungsdokument beiden gegenüber vertrauen und dann in deinem eigenen Dashboard bestätigen.
Bei älteren Plänen sagt das Dokument, dass die Forms-Nutzung Submissions (verifizierte Übermittlungen pro Abrechnungsperiode) und File uploads (Gesamtspeicher) verfolgt, pro Website gemessen. Bei einem Level-Limit wechselt die Website automatisch zur nächsten Stufe oder zum nächsten Paket, und Konten der kostenlosen Stufe werden ebenfalls mit einem Limit gemessen. Die einzige Zahl, die ich für dieses Limit gesehen habe, 100 Übermittlungen pro Website pro Monat, stammt aus der Rezension von splitforms.com, nicht von Netlify's Seiten. Überprüfe dies, bevor du dich darauf verlässt.
Weder die Preisseite noch das Abrechnungsdokument trägt ein Datum, öffne also beide, wenn du das hier liest.
Tabelle zur Fehlerbehebung
Die Lösungen unten stammen von Netlify's FAQ zur Fehlerbehebung (datiert 3. Oktober 2026) und Tipps zur Fehlerbehebung bei Formularen (datiert 16. September 2026), plus den Setup-Dokumenten.
| Symptom | Ursache | Lösung |
|---|---|---|
| Formular wird nie in der Netlify-Benutzeroberfläche angezeigt | Client-seitig gerendert oder Erkennung deaktiviert | Füge eine statische HTML-Kopie mit übereinstimmenden Namen hinzu, aktiviere die Erkennung und stellen neu bereit |
| Ein neues Feld fehlt in den Übermittlungen | Feld nicht in der statischen HTML-Version vorhanden | Füge das Feld zum statischen Formular hinzu und stelle neu bereit |
| Nichts passiert nach dem Aktivieren der Erkennung | Es gilt nur für neue Deploys | Stelle die Website neu bereit |
| Test-Einträge nicht in verifizierten Übermittlungen | Akismet hat sie gekennzeichnet | Überprüfe Spam-Übermittlungen, verwende eine echte E-Mail-Adresse, vollständige Sätze und zeitliche Abstände zwischen Tests |
| Übermittlungen verschwinden mit Honeypot | Honeypot-Feld fehlend oder ausgefüllt | Das Feld in den POST-Body einbeziehen; FormData() verwenden |
| AJAX-POST schlägt fehl oder wird ignoriert | Body als JSON versendet | Body URL-codieren |
| Next.js-Attribute haben keine Wirkung | Seiten sind keine statischen HTML-Dateien | Statische Formulardatei in public, Absendung per AJAX |
| Alte Daten weg nach Umbenennung eines Felds | UI zeigt nur aktuelle Felder an | Verwenden Sie den API-Endpunkt listFormSubmissions; verstecken Sie alte Felder, anstatt sie zu löschen |
Falls das Formular stumm nichts tut, arbeiten Sie die ersten drei Reihen der Reihe nach ab. Das ist die Mehrzahl der Fälle.
Wenn ein anderes Backend besser passt
Netlify Forms ist eine gute Standardwahl, wenn Sie bereits auf Netlify sind und ein Kontaktformular benötigen. Es ist nicht immer die richtige Wahl.
Bei WordPress bleiben
Falls Ihre Website auf WordPress läuft und das Formular bereits funktioniert, gibt es selten einen Grund, es zu verschieben. Contact Form 7, WPForms und ähnliche Plugins laufen auf Ihrem eigenen Server, halten Daten in Ihrer eigenen Datenbank und sitzen in dem Editor, den Ihr Team bereits kennt. Falls E-Mails nicht ankommen, ist das ein Zustellproblem, das Sie vor Ort lösen können: siehe warum Contact Form 7 keine E-Mails mehr versendet. Ein Formular zu Netlify zu verschieben macht nur Sinn, wenn die gesamte Website auch zu einem statischen Build wechselt. Das ist eine Hosting-Entscheidung, und Vercel versus Netlify ist ein sinnvoller Ort, um das abzuwägen.
Formspree und ähnliche Form-Backends
Ein gehostetes Form-Backend macht Sinn, wenn Ihre Website nicht über Netlify's Build bereitgestellt wird. Netlify Forms hängt von der Erkennung beim Deployment ab, daher funktioniert es nur bei Websites, die dort bereitgestellt werden. Ein Formular-Service gibt Ihnen einen Endpunkt, der von jedem Host aus funktioniert. Static Forms' Vergleich listet beispielsweise einen kostenlosen Tarif von 250 Einreichungen alle 30 Tage auf, ihre eigene Angabe auf ihrer eigenen Seite. Formspree funktioniert nach demselben Prinzip, aber ich zitiere hier nicht seine Limits. Überprüfen Sie seine Pricing-Seite.
Eine Serverless-Funktion
Wenn Sie gegen eine Datenbank validieren, eine benutzerdefinierte E-Mail versenden oder eine andere API aufrufen müssen, gibt Ihnen eine Funktion volle Kontrolle und die Kosten sind Code, den Sie verwalten. Netlify's Astro-Template verweist in seinen Ressourcen auf formularausgelöste Funktionen, was Ihnen einen mittleren Weg eröffnet: Netlify Forms für Speicherung und Spam behalten und Code pro Einreichung ausführen.
Ein CMS- oder Builder-Formular
Falls Redakteure Felder ändern müssen, ohne Code anzufassen, gewinnt ein in das CMS oder den Page Builder integriertes Formular. Statische HTML-Blueprint-Dateien sind das Gegenteil von editorfreundlich.
FAQ
Kann ich Netlify Forms auf einer Website verwenden, die woanders gehostet wird?
Nicht auf die Weise, wie Sie es sich erhoffen würden. Die Erkennung erfolgt in Netlify's Build, daher muss sich das Formular in einem Netlify-Deploy befinden. Eine Bewertung von Drittanbietern sagt dasselbe: Formulare funktionieren auf Websites, die bei Netlify bereitgestellt werden.
Warum gehen Antworten an die falsche Adresse?
Fügen Sie ein <input name="email"> zum Formular hinzu. Die Knowledge Base sagt, dass die Benachrichtigungs-E-Mail's Reply-to auf den Absender setzt.
Sollte ich die Formerkennung deaktivieren, wenn ich meine Formulare entferne?
Das ist vernünftig. Netlify sagt, dass das Deaktivieren die Nachbearbeitung reduziert und Bereitstellungen beschleunigen kann. Du bestätigst das durch Eingabe des Site-Namens, und es gilt ab der nächsten Bereitstellung.
Kann ich Dateien sammeln, die personenbezogene Daten enthalten?
Netlify sagt, dass Formulare mit Uploads, die PII enthalten, eine zusätzliche Sicherheitskonfiguration benötigen, und empfiehlt die Very Good Security-Integration. Denk auch an die Limits von einer Datei pro Feld und 8 MB pro Anfrage.
Die wichtigste Einschränkung: Netlify erkennt nur Formulare, die zur Bereitstellungszeit als statisches HTML vorhanden sind, daher benötigt jedes von einem Framework gerendertes Formular eine statische Kopie mit passenden Feldnamen. Wenn du einen Wechsel zu einem statischen Stack erwägst und eine zweite Meinung zum Build möchtest, Jamstack-Entwicklungsservices decken diese Art von Arbeit ab.
