After developing and testing your project locally, you can take it to production. This article guides you through that process for a Wix-managed headless project built with a framework other than Astro.
Using Astro? Wix builds Astro projects for you, so the flow starts with wix build. See Build and Deploy with the CLI for the full integration instead.
To create a project in the first place, see Deploy Your Own Frontend with the CLI.
Make sure that you have:
wix.config.json file.Wix doesn't build projects that aren't built with Astro, so build locally with your framework's own tooling.
Make sure that outputDirectory in wix.config.json points at the folder your framework actually builds to. It defaults to ./dist. To deploy server code alongside your client files, set outputDirectory to an object with separate client and server paths.
Note: Wix runs server files as long as they're built for the Cloudflare Workers runtime.
A preview URL is a link you can share with team members that allows them to preview and test your project. Each preview URL directs to a unique version of your project hosted on Wix's servers. Subsequent updates to your project won't affect any previously created versions.
To push your build output to Wix's servers and create a preview URL, run the preview command:
To push your project to Wix's servers and publish it, run the release command and follow the prompts:
After releasing your project, the CLI provides the URL of your published site, along with preview URLs for your project and dashboard.
Tip:
Releasing also clears your entire site cache, so visitors get the latest version. If you've deployed an update but still see outdated content, run npx wix release again to clear the cache.
You now have a fully working project. Use the following resources to continue building it:
Last updated: 29 July 2026