About Wix Headless

Build a custom frontend on the stack of your choice, backed by production-ready Wix business APIs, with built-in compliance (SOC 2 Type II, HIPAA, GDPR) and a full management dashboard out of the box.

Wix Headless gives you:

  • Broad API coverage: Tap into Wix business solutions such as eCommerce, bookings, events, memberships, CMS, and blog, all under a single auth model and consistent API pattern.
  • Pre-built business flows: Leverage Wix-hosted pages for complex business flows like checkout, booking, and ticket purchases, so you don't have to build them from scratch.
  • Multiple frontends, one project: A website, mobile app, and other clients can share the same underlying business data and Wix business solutions.

Wix Headless offers two development paths: Wix-managed headless (recommended) and self-managed headless. The Wix-managed path adds built-in authentication, hosting, and deployment. For a detailed comparison, see About Development Paths.

Get started

The following command creates a Wix-managed headless Astro project. You can build the UI with React, Vue, Svelte, Solid, or other Astro integrations. If you need a different framework, such as Next.js or SvelteKit, set up self-managed headless.

To create a project, run:

Copy

For non-interactive use (AI tools or scripts), pass the required project details as flags:

Copy

For the full list of flags, see the create headless command.

Your new project appears in your Wix dashboard alongside your sites.

Build with AI

For AI coding clients like Claude Code, Cursor, and VS Code, install the Wix Plugin to give your AI client the context it needs to build and manage your headless project.

The Wix Plugin includes:

  • Wix Skills: A collection of self-contained instruction sets for Wix development tasks. This includes the Wix Headless skill, which can scaffold and deploy a complete headless project from a single prompt.
  • Wix MCP: A Model Context Protocol server that lets your AI tool search Wix docs, scaffold code, and call Wix APIs directly from your IDE.

To install just Wix Skills, run:

Copy

Note: Add -g to install globally and make Wix Skills available across all your projects.

Programmatic docs access

Beyond the Wix Plugin, you can pull Wix docs into any tool or workflow:

  • llms.txt index: Browse a structured index of all documentation at dev.wix.com/docs/llms.txt.
  • Markdown format: Append .md to any documentation page URL to retrieve the Markdown version of that page.
  • Page menu: Use the Ask Assistant dropdown on any documentation page to copy the page as Markdown or get a direct link to the Markdown version.

Pricing

Wix Headless is free to start. Upgrade to a premium plan to unlock payments, in-depth analytics, custom domains, and more.

Get in touch

Join the Headless channel of the Devs on Wix Discord community to discuss features and connect with our growing community of developers.

Next steps

Did this help?