About Wix-Managed Headless

Wix-managed headless is the recommended path for building headless projects on Wix. It's a fully managed solution that combines Wix business solutions with managed infrastructure, automatic authentication, and a modern development stack, so you can focus on building your frontend while Wix handles the backend complexity.

Unlike self-managed headless, you don't need to configure OAuth, manage authentication tokens, or set up hosting. Wix handles builds, deployments, scaling, and security for you.

Benefits

When you create a Wix-managed headless project, you get a complete development environment backed by Wix infrastructure:

  • Managed hosting with global CDN: Wix builds, deploys, and serves your project on a global content delivery network with automatic SSL certificates. The infrastructure scales automatically to meet traffic demands.
  • Automatic authentication: Visitor sessions, member login flows, and token management are all handled for you. You can call Wix SDK methods directly in your code. The SDK is pre-configured with the right credentials, so there's no client setup or token management required.
  • Astro-based framework: 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 wherever you need them.
  • Extend with custom backend logic and dashboard UIs: Use extensions to handle events like order placements, customize business logic, and build management interfaces that appear in the Wix dashboard.
  • Analytics tracking: Track events like page views, cart actions, and purchases, and forward them to connected analytics platforms such as GA4 and Facebook Pixel.

Ways to work with Wix-managed headless

You can develop Wix-managed headless projects through code with the Wix CLI, through a visual UI with Wix Vibe, or with a combination of both.

Wix CLI

The Wix CLI is the code-first approach. You develop locally in your preferred IDE, use standard coding practices, and deploy through the CLI. The Wix-Managed Headless documentation focuses on this approach, covering the architecture, authentication model, extensions, and development workflow of CLI-based headless projects.

To get started, see Quick Start with the Wix CLI.

Wix Vibe

Wix Vibe is a UI-based approach that lets you create, edit, and manage your project using conversational AI prompts. You describe what you want to build, and Vibe generates the project structure, pages, and components for you. Projects started in Vibe can always be opened locally and developed with the CLI.

To get started, see Build with Wix Vibe.

Create a project

You also don't need to create the project in the Wix dashboard first. To create a Wix-managed headless project with the CLI, run the create command. The command provisions the business and site for you and scaffolds the local codebase in 1 step.

A business is the workspace in your Wix account that holds a single site, its dashboard, and settings such as billing. Each business appears on the Sites page of your Wix account, and one Wix account can hold multiple businesses.

For a full walkthrough, see Quick Start a Headless Project.

Key concepts

The following articles explain the core concepts behind Wix-managed headless projects:

  • Architecture and project structure: The Astro framework, project file structure, private app, and hosting infrastructure that power your project.
  • Authentication and API integration: How automatic authentication works for visitors, members, and admins, and how you call Wix APIs in your code.
  • Extensions: Backend event handlers, service plugins, and dashboard UIs that extend your project beyond the frontend.
  • Development, build, and deployment: Local development with hot reloading, the build-preview-release workflow, environment variables, and AI-assisted development with Wix Skills.

When you're ready to start building, see Get Started for a guide to choosing your entry point and next steps.

Comparison with self-managed headless

Self-managed headless gives you full control over your framework, hosting, and authentication setup. Wix-managed headless trades some of that flexibility for a faster, more automated development experience.

For a detailed comparison of both paths, including a feature-by-feature table, see About Headless Development Paths.

See also

Did this help?