About Wix Headless

Build a custom frontend on the stack of your choice, backed by production-ready Wix business APIs and a full management dashboard out of the box.

Wix Headless offers two development paths: Wix-managed headless (recommended) and self-managed headless. For a full comparison, see About Development Paths.

Regardless of which path you choose, you get:

  • Deep business 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.
  • Compliance handled for you: Wix takes care of consent flows and certifications (SOC 2 Type II, HIPAA, GDPR) across every API, so you don't need to negotiate it per vendor.
  • Multiple frontends, one project: A website, mobile app, and other clients can share the same underlying business data and Wix business solutions.
  • AI-native tooling: Wix provides robust tools for AI-assisted development.

When you choose Wix-managed headless, you also get built-in authentication, hosting, and more. Learn more about the benefits of Wix-managed headless.

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 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.

For programmatic docs access:

  • 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?