Wix Headless lets you build your frontend with any framework and integrate with Wix’s production-ready business solutions such as eCommerce, Bookings, and Events.
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.
Wix Headless supports the following development paths, depending on how much setup and hosting you want to manage yourself. Both paths allow you to connect to Wix backend services using Wix APIs.
Note: This path requires less setup and is the recommended option.
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.
Wix-managed projects are built on Astro and support React, Vue, Svelte, and Solid components.
To get started, see Quick Start a Headless Project, or run npm create @wix/new headless. The command also supports a non-interactive mode via flags. This is useful for AI assistants, scripts, and CI pipelines.
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 build your Wix-managed headless project with AI in two ways: use Wix Vibe, Wix's own AI editor, or pair the Wix CLI with an AI assistant of your choice, such as Claude Code, Cursor, or VS Code.
Wix Vibe is an AI-powered tool for bootstrapping and editing Wix-managed headless projects through conversational prompts. Use Vibe when you want a guided, UI-based experience without setting up a local development environment.
If you prefer to develop locally, use the Wix CLI alongside an AI assistant such as Claude Code or Cursor. To give your assistant Wix-specific context, install the Wix plugin, which bundles Wix Skills and the Wix MCP. Your assistant can then search Wix docs, scaffold code, and call Wix APIs from inside your IDE.
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.