Next.js newsletter signup form
A single-field email capture for your mailing list.
Recommended fields
| Field | Type | Required |
|---|---|---|
| Yes |
The code
Define an inline `"use server"` action that forwards the FormData to your FormLoom endpoint. No client JS required — it works with JavaScript disabled and progressively enhances. For richer UIs, pair it with `useActionState` for pending/error states.
Server Action (recommended)
app/contact/page.tsx
// app/contact/page.tsx — Next.js 15 App Router, Server Action
export default function ContactPage() {
async function submit(formData: FormData) {
"use server";
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(formData)),
});
// FormLoom scores spam, stores the row, and emails you — no backend to wire.
return res.json();
}
return (
<form action={submit}>
<label>
Email
<input type="email" name="email" required />
</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>
);
}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>
Email
<input type="email" name="email" required />
</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 = {
email: 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({
email: form.email.value,
});Tips
- Keep it to one field — email only — for the highest conversion.
- Wire an autoresponder to send a welcome / double-opt-in email.
FAQ
Usually not — email-only forms convert best. Collect the name later in your welcome email if you need it.