Skip to main content
Astro’s zero-JS-by-default philosophy and a form backend are a natural pair: your contact form stays plain HTML in a .astro component, ships no JavaScript, and still works — no SSR adapter or API endpoint required.

​
Before you start: create your endpoint

Every guide on this page needs a Crunchforms form ID. Getting one takes about two minutes:
  1. Sign up free — 1,000 submissions a month included, no credit card required.
  2. In your dashboard, click New Form, give it a name, and pick a response type: Redirect for classic form posts (the visitor lands on your thank-you page), or JSON if you’ll submit with JavaScript and handle the response yourself.
  3. Your endpoint is https://crunchforms.com/form/{formID} — copy it with the Copy Action URL button, or use the dashboard’s snippet generator.
The quickstart covers this in more detail.

​
The form component

src/components/ContactForm.astro
<form action="https://crunchforms.com/form/{formID}" method="post">
  <label for="name">Name</label>
  <input name="name" type="text" id="name" required />

  <label for="email">Email</label>
  <input name="email" type="email" id="email" required />

  <label for="message">Message</label>
  <textarea name="message" id="message" rows="5" required></textarea>

  <button type="submit">Send message</button>
</form>
Use it anywhere:
src/pages/contact.astro
---
import Layout from '../layouts/Layout.astro';
import ContactForm from '../components/ContactForm.astro';
---
<Layout title="Contact">
  <h1>Get in touch</h1>
  <ContactForm />
</Layout>
Set the form’s response type to Redirect with your thank-you page as the success URL — the visitor never knows a third party was involved.

​
Want inline feedback instead?

Add a small island (or a plain <script> tag) that submits with fetch and set the response type to JSON — the endpoint accepts cross-origin JSON posts and answers { "success": true }. The React, Vue, and Svelte guides show the pattern for whichever island framework you use.

​
Stop the spam before it starts

Every public form gets found by bots eventually. Crunchforms filters submissions server-side on every plan, including Free:

Honeypot

A hidden field humans never see — if it’s filled, the submission is rejected. Zero friction for real visitors.

Cloudflare Turnstile

Invisible bot detection. Add the widget to your form and Crunchforms validates the token server-side.

reCAPTCHA v3

Score-based validation with a threshold you control per form.
The honeypot alone stops most drive-by spam and takes one extra line of markup — enable it in your form’s settings, then include the hidden field in your form.

​
Troubleshooting

  • Check the form is set to Active in your dashboard.
  • If you’ve enabled Turnstile or reCAPTCHA on the form, submissions without a valid token are rejected — including your own tests.
  • Check you haven’t exceeded your plan’s monthly submission quota.
Set the form’s response type to Redirect and provide a success URL (and a failure URL) in the form settings. If you’re submitting with JavaScript, use the JSON response type instead and navigate in your code.
The endpoint accepts cross-origin requests, JSON bodies (Content-Type: application/json), and classic URL-encoded form bodies. Set the form’s response type to JSON so your code gets { "success": true } back instead of a redirect.
Use the Send Test Submission action next to your form in the dashboard — it posts a sample submission to your live endpoint so you can see the pipeline working end to end.

​
Next steps

Form configuration

Response types, notification emails, daily summaries, and more

Free HTML form templates

Contact, feedback, RSVP, job application, and quote-request forms ready to paste

​
Need help?

Get Support

Send us a note — we read everything.