With Wix CLI you can develop, test, and deploy Wix projects directly from your terminal. This reference guide provides detailed documentation for all available CLI commands.
Which commands you can use depends on where you run them:
init: The global commands, and the preview, release, env pull, env set, and env remove project commands.These commands scaffold a new project. They're provided by the @wix/create-new package and are invoked through npm create, before a project exists locally.
| Command | Description |
|---|---|
| npm create @wix/new app | Creates a new Wix app project, including registering a new app in your account (or extending an existing one) and scaffolding from a template. |
| 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. |
These commands operate on an existing Wix CLI project. Run them from your project directory.
| Command | Description |
|---|---|
| dev | Starts a local development environment that serves your project. |
| dev-site | Manages the development site used by the current app. Apps only. |
| build | Builds your project. |
| generate | Generates an extension for your project. |
| preview | Creates an online preview of your built project. |
| release | Starts a process that guides you through releasing your project. |
| schema | Prints a JSON schema of the available extension types and their required inputs. |
| skills add | Adds Wix skills to your project. |
| skills update | Updates Wix skills in your project to the latest version. |
| env pull | Pulls all your environment variables from Wix's servers and merges them into the .env.local file. |
| env set | Sets an environment variable on Wix's servers. |
| env remove | Removes an environment variable from Wix's servers. |
| translation pull | Pulls the translations from the Multilingual dashboard. |
| translation push | Uploads translation keys to the Multilingual dashboard. |
These commands work outside the context of a specific project.
| Command | Description |
|---|---|
| login | Logs in to your Wix account. |
| logout | Logs out of your Wix account. |
| whoami | Displays the email address of the logged-in Wix user. |
| telemetry | Opts in or out of sending usage information and error reports (telemetry) to Wix. |
| account | Manages your Wix account, including its domains. |
| token | Prints the current access token, account-level or site-scoped, for direct REST API calls. |
Most Wix CLI commands follow this general syntax:
Where:
<command> is the primary action (for example, dev, build, release)[subcommand] is an optional secondary action (for example, env set)[flags] are optional parameters that modify the command's behaviorProject creation commands are an exception. They're provided by a separate package and use the following syntax:
The -- separator forwards everything after it to the @wix/create-new package instead of consuming the flags itself.
Last updated: 19 October 2026