Build your frontend with any framework while connecting to Wix's production-ready business solutions, including eCommerce, Bookings, and Events. Wix manages the backend so you can focus on building your product.
Headless projects appear in your Wix account alongside your Wix sites and are managed through the same dashboard. From there, you can manage customers, process orders, and track analytics.
You can connect multiple frontends to a single Wix project. For example, a website, mobile app, and other clients can share the same underlying business data.
To create a new Wix-managed headless project, run:
The command supports non-interactive mode via flags, which is useful for AI tools, scripts, and CI pipelines. For a step-by-step walkthrough, see Quick Start a Headless Project.
To let your AI tool scaffold and deploy a complete site from a single prompt, install the Wix Headless skill by running wix skills add. Run wix skills update to keep your skills up to date.
Wix-managed headless is the recommended starting point. If you want to use a different frontend framework or manage your own hosting and deployment, you can use self-managed headless instead.
Wix-managed headless is a fully managed solution for developing and hosting your headless project. The Wix CLI creates the entire project for you, including provisioning the business and site, from a single command. You don't need to do any prior setup in the Wix dashboard.
Your project is built on the Astro web framework, which gives you fast, server-rendered pages with the flexibility to use components from React, Vue, Svelte, or Solid.
If you have specific hosting requirements or need to integrate Wix into an existing site, you can use self-managed headless instead. You build your frontend from scratch with any framework, host it anywhere, and handle all configuration, authentication, and deployment yourself. Most projects should use the Wix-managed path above.
You can also connect an existing Wix site to a headless client. This effectively turns a site into the backend for a self-managed headless project, giving the client access to the site's existing data and functionality.
Use this path to migrate existing site data and functionality to a custom frontend or to extend a site with additional frontends.
You can build your headless project with AI using Wix Vibe, Wix's own AI editor, or the Wix CLI paired with an AI tool of your choice, such as Claude Code or Cursor.
Wix Vibe is an AI-powered website builder where Vibe itself serves as your frontend. Use conversational prompts to rapidly build out your site's style and structure, where Vibe handles design and customization work much like generating a custom template. The hosting and business management options are the same as with the Wix CLI path.
If you choose to continue developing locally, just connect your Vibe project to a GitHub repository and continue with the Wix CLI. From that point, the workflow is identical to a standard Wix-managed headless project.
If you prefer to develop locally, use the Wix CLI alongside an AI tool such as Claude Code or Cursor. If you didn't install the Wix plugin during project creation, you can add it at any time. It includes the Wix MCP, which lets your AI tool search Wix docs, scaffold code, and call Wix APIs from inside your IDE.
Wix developer documentation is available in machine-readable formats for use with AI coding assistants and LLMs:
.md to any documentation page URL to retrieve a Markdown version of that page.While you can start using Wix Headless for free, upgrading to a Premium Plan unlocks advanced features that help you grow your business. These include receiving payments, accessing in-depth analytics, connecting a custom domain, and other features. Consider upgrading to a Premium Plan.
Join the Headless channel of the Devs on Wix Discord community to discuss features and connect with our growing community of developers.