Will it work on Gatsby Cloud / Netlify static hosting?

Yes — it's a static page making a client-side request, so any static host works.

Gatsby contact form

Verified against Gatsby 5.x · June 2026

Gatsby builds to static HTML + React. There's no server at runtime, so the contact form POSTs straight to FormLoom from the browser. It's the standard React client-fetch pattern.

Customize in the generator Full Gatsby guide

The code

Use a React component with an `onSubmit` handler that `fetch`es FormLoom. No Gatsby Functions required for the basic case.

React component (client)

ContactForm.tsx

// ContactForm.tsx — React (works in Vite, CRA, Next 'use client')
"use client";
import { useState } from "react";

export function ContactForm() {
  const [status, setStatus] = useState<"idle" | "ok" | "error">("idle");

  async function onSubmit(e: React.FormEvent<HTMLFormElement>) {
    e.preventDefault();
    const form = e.currentTarget;
    const res = await fetch("https://formloom.vercel.app/api/submit/YOUR_ACCESS_KEY", {
      method: "POST",
      headers: { "Content-Type": "application/json", Accept: "application/json" },
      body: JSON.stringify(Object.fromEntries(new FormData(form))),
    });
    setStatus((await res.json()).success ? "ok" : "error");
    if (status !== "error") form.reset();
  }

  if (status === "ok") return <p>Thanks — we got your message.</p>;
  return (
    <form onSubmit={onSubmit}>
      <label>
        Name
        <input type="text" name="name" required />
      </label>
      <label>
        Email
        <input type="email" name="email" required />
      </label>
      <label>
        Message
        <textarea name="message" required placeholder="How can we help?"></textarea>
      </label>
      <!-- honeypot: bots fill this, humans don't see it -->
      <input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off" />
      <button type="submit">Send</button>
    </form>
  );
}

@formloom/client (typed SDK)

submit.ts

// npm i @formloom/client
import { createForm } from "@formloom/client";

type Contact = {
  name: string;
  email: string;
  message: string;
};

const form = createForm<Contact>("YOUR_ACCESS_KEY");

// End-to-end typed: TS errors if you send the wrong shape.
const { success, message } = await form.submit({
  name: form.name.value,
  email: form.email.value,
  message: form.message.value,
});

AJAX fetch (vanilla JS)

contact.html

<form id="contact-form">
  <label>
    Name
    <input type="text" name="name" required />
  </label>
  <label>
    Email
    <input type="email" name="email" required />
  </label>
  <label>
    Message
    <textarea name="message" required placeholder="How can we help?"></textarea>
  </label>
  <!-- honeypot: bots fill this, humans don't see it -->
  <input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off" />
  <button type="submit">Send</button>
</form>

<script>
const form = document.getElementById("contact-form");
form.addEventListener("submit", async (e) => {
  e.preventDefault();
  const res = await fetch("https://formloom.vercel.app/api/submit/YOUR_ACCESS_KEY", {
    method: "POST",
    headers: { "Content-Type": "application/json", Accept: "application/json" },
    body: JSON.stringify(Object.fromEntries(new FormData(form))),
  });
  const data = await res.json();
  if (data.success) {
    form.reset();
    alert("Thanks — we got your message.");
  } else {
    alert(data.message || "Something went wrong.");
  }
});
</script>

Gotchas

Gatsby Functions exist but you don't need them — the client POST is enough.
Hydration: keep the form simple so it hydrates cleanly.

Form types for Gatsby

Tailored field sets and code for common use cases.

Gatsby contact form Gatsby newsletter form Gatsby waitlist form Gatsby feedback form Gatsby support ticket form Gatsby lead capture form Gatsby rsvp form Gatsby job application form Gatsby survey form Gatsby bug report form

FAQ

No. The client-side fetch POSTs directly to FormLoom; functions are optional.