Wix-managed headless is the recommended path for building headless projects on Wix. Wix hosts and runs your frontend and connects it to Wix business solutions, handling deployments, scaling, and security, so you can focus on building.
Every Wix-managed headless project runs on Wix infrastructure, whatever framework you build with:
- Managed hosting with global CDN: Wix deploys and serves your project on a global content delivery network with automatic SSL certificates and deploy previews. The infrastructure scales automatically to meet traffic demands.
- Wix business APIs: Connect your frontend to Wix business solutions like Stores, Bookings, and Events.
- Wix CLI: Preview, release, and manage your project from the terminal, useful for both manual and AI-agent workflows.
How much Wix handles for you depends on the framework you build with. Build with Astro for the full integration, where Wix also handles authentication, SEO, analytics, monitoring, secrets, and extensions. Bring another web framework for a limited integration, where Wix hosts and runs your site but you build it locally and set up authentication yourself.
For what each option gives you, see About Supported Frameworks.
Note: If you need a framework Wix-managed doesn't support, or want your own hosting provider, use self-managed headless instead. It supports any framework, but you handle hosting and deployment yourself.
How you create a project depends on your framework. Follow the matching quick start.
To publish from a prompt without the Wix CLI, follow Quick Start with AI. A chat tool keeps the source on Wix.
With Astro, Wix's Astro integration handles authentication for you:
- Build with a Coding Agent: A coding agent saves an Astro project in a folder. Continue from that folder with the Wix CLI.
- Quick Start with the Wix CLI: Scaffold a new Astro project from your terminal. To start from a prebuilt template, see Astro Templates.
- Quick Start from an Existing Astro Project: Link an Astro project you already have.
With another web framework, you set up authentication yourself:
- Deploy Your Own Frontend with the CLI: Initialize and deploy an existing frontend from your terminal.
- Upload a Static Site: Upload HTML, CSS, and JavaScript without using a terminal.
- Send a Claude Design to Wix: Send a Claude Design build directly to Wix.
- Publish a Site from Figma: Turn selected Figma frames into a live site. Each frame becomes a page.
Whichever quick start you choose, your new project appears in your Wix dashboard alongside your sites.
How you continue depends on how the project was created:
- Uploaded sites, Figma sites, Claude Design sites, and chat tool sites: Wix keeps the source. Click Edit Frontend in the dashboard to open the site in another AI tool or upload new files.
- Astro projects from a coding agent or the CLI: Continue from the project folder. Edit Frontend doesn't open these projects in another tool.
You can move an existing site to a Wix-managed headless site:
- Move a WordPress or WooCommerce site: Migrate Your WordPress Site to Wix Headless. An AI agent imports your content into a new Wix project, and you can include a Wix-managed frontend.
- Move an existing Wix site to Headless: This works for a site with a connected domain. A site owner or a co-owner can start the move. You build the new frontend with an AI tool and preview it without changing the live site. When you're ready, switch to it. Your business tools and data keep running, and your domain moves to the new frontend. See Moving Your Site to a Custom Frontend. After you migrate, use the Post-Migration Checklist: Wix Studio and Editor Sites to Headless to verify or rebuild features that don't carry over.