GET form schema
JSON schema includes the rendered HTML and a structured field list for client-side validation.
Developer tools
Headless / Astro / Next in Core Forms
Render and submit Core Forms from Astro, Next.js, or any non-WordPress site.
Bundled with Core Forms — the WordPress forms plugin with every premium feature in the box. No add-on tax.
Every form can be exposed via REST so an external site can render it and post submissions. The same validation, captcha, action-loop and payment-redirect machinery runs server-side in WordPress — your headless site just submits JSON.
Single API key per site (under Settings → Headless), per-form opt-in toggle, and three integration modes: a drop-in vanilla JS widget, a native fetch example, and a cURL recipe. The widget fires `cf:mounted`, `cf:submit`, `cf:success` and `cf:error` events on the host element so any framework can hook in.
What you get
How Headless / Astro / Next works in Core Forms
POST submit endpoint
Drives the same Forms::process() pipeline as on-site submissions — captcha, akismet, actions, payments.
embed.js widget
Drop a <div data-cf-form="…"> + <script src=".../embed.js"> and the form mounts itself.
CORS-friendly
Origin reflected per-request. No credentials required, captcha enforced as the spam stop.
Set it up
Connect Headless / Astro / Next in 3 minutes
- 1
Set the API key
WP Admin → Core Forms → Settings → Headless → click Generate, save.
- 2
Flip the form toggle
Form editor → Headless tab → enable. Copy a snippet (widget, fetch, or cURL).
- 3
Paste into your site
Astro / Next / Vue / Svelte / static HTML — the snippet is framework-agnostic.
Watch
Headless WordPress forms with Core Forms — full walkthrough
Five-minute walkthrough of the headless setup: API key, allowed origins, per-form toggle, and the three integration modes (drop-in widget, native fetch, server-side proxy).
Drop-in vanilla JS embed
<div data-cf-form="contact" data-cf-key="YOUR_SITE_API_KEY"></div>
<script src="https://yoursite.com/wp-json/core-forms/v1/embed.js" defer></script>Sample code
Download a starter for your stack
Working examples — sanitized, ready to drop in. Replace the placeholder values at the top of each file (form ID, upstream URL, allowed origins, API key) and ship. No private data inside; nothing tracks back to anyone’s production site.
- Astro page
support.astroServer-side fetch of the form HTML + client-side submit through your own proxy. The exact pattern core-forms.com /support uses. - Cloudflare Worker
worker.tsServer-side proxy that injects the X-Core-Forms-Key header so the key never reaches the browser. - Wrangler config
wrangler.jsoncPairs with worker.ts — sets the upstream + form ID as vars; the API key goes in via `wrangler secret put`. - Next.js page
nextjs-page.tsxApp Router page that fetches the form HTML server-side at request time. Pair with nextjs-route.ts. - Next.js API route
nextjs-route.tsEdge-runtime POST handler. Holds the API key in process.env, forwards submissions to WordPress. - PHP proxy
submit.phpDrop on any PHP host. Reads creds from environment variables, proxies submissions via cURL. - Node.js / Express
node-express.jsSingle-file Express server. Node 18+ — uses global fetch, no extra dependencies beyond Express. - Plain HTML
embed.htmlDrop-in widget — two lines, no build step, no framework. The API key lives in the page source; pair with the proxy patterns for production use.
Inside Core Forms
See it in WP-Admin
Pairs well with
Related integrations
Bundled with every Core Forms license.
Headless / Astro / Next — and every other integration on this site — is included with your
license. Use code CFLAUNCH for 20% off either plan.