HeadlessImproved in 5.16+

Freeform supports headless website architecture for JavaScript front ends such as React, Next.js, Vue.js, and Nuxt.

Official npm PackagesNew in 5.16+

Freeform 5.16+ now includes official npm packages (@solspace/freeform-react or @solspace/freeform-vue) and a headless REST API. Start with Getting Started to enable headless and install the packages, or try the React, Vue, and Nuxt demos.

For projects already using Craft GraphQL, we recommend using the headless GraphQL adapters.

Getting Started

Enable the headless API and install the official React or Vue packages.

REST API

Manifest, submit, CSRF, CORS, file uploads, and payment routes.

React JS

Render forms with <Freeform /> or build your own UI with useFreeform().

Next.js

App Router Client Components, rewrites proxy, and CSRF-friendly setup.

Vue.js

Render forms with <Freeform /> or build your own UI with useFreeform().

Nuxt

Client-only Freeform components, /freeform proxy, and CSRF-friendly setup.

GraphQL

Headless manifest/submit adapters, plus legacy form queries and mutations.