With the Wix CLI, you can develop, test, and deploy Wix headless projects from your terminal. This reference documents the commands for headless projects.
The sections of this article are organized by command type, and each section describes the syntax of its commands. Every command accepts -h and --help, which print the command's usage and flags.
The commands you can use depend on where you run them:
init: The preview, release, and env project commands.These commands create a Wix-managed headless project, from a template or from code you already have. They're provided by the @wix/create-new package, so they run through npm create, not as wix commands.
| Command | Description |
|---|---|
| npm create @wix/new headless | Creates a new Wix headless project, including provisioning a Wix business and site, scaffolding from a template, and initializing local files. |
| npm create @wix/new headless link | Links an existing Astro project to Wix, provisioning a Wix business and site for it. |
| npm create @wix/new init | Initializes a Wix-managed headless project in the current folder, without prompts. |
Project creation commands use this syntax:
Angle brackets mark a required part, and square brackets mark an optional part. Don't type the brackets.
The -- separator tells npm to forward everything after it to the @wix/create-new package, instead of treating the flags as options for npm create itself.
These commands operate on a project that uses the headless project structure. Run them in the project's folder.
| Command | Description |
|---|---|
| dev | Starts a local development environment that serves your project. |
| build | Builds your project. |
| generate | Generates an extension for your project. |
| schema | Prints a JSON schema of the available extension types and their required inputs. |
| preview | Creates an online preview of your built project. |
| release | Releases your project and publishes its site. |
| env | Manages your project's environment variables on Wix's servers. |
| translation | Manages your project's translations in the Multilingual dashboard. |
| skills | Manages the Wix skills in your project. |
Project commands follow this general form:
Angle brackets mark a required part, and square brackets mark an optional part. Don't type the brackets.
Where:
<command> is the primary action (for example, dev, build, release)[subcommand] is a secondary action for commands that have subcommands (for example, set in wix env set)[flags] are parameters that modify the command's behaviorWhen a command requires a subcommand, its Usage section shows <subcommand>. Running the command without a subcommand prints the command's help and exits with an error code.
You don't need to be in a project folder to run standalone commands. Unlike the global commands, standalone commands are documented in the headless reference, although they run in any project or folder.
| Command | Description |
|---|---|
| account | Manages your Wix account, including its domains. |
Standalone commands follow the same general form as project commands:
Angle brackets mark a required part, and square brackets mark an optional part. Don't type the brackets.
Last updated: 10 November 2026