wix.config.json links your local project to your Wix-managed headless project. Wix creates it for you when you initialize a project from your terminal, upload a site, or send a Claude Design.
This article covers the fields you set when you build with a framework other than Astro. For the file's role in the wider CLI project structure, see CLI Project Structure.
Your project's OAuth client ID. Wix creates a client for you and stores its ID here, so you don't need to create one in the dashboard.
Use this value as the clientId when you create a Wix client. See Create an SDK Client with OAuth.
Tells Wix which folder to deploy. Releasing doesn't build your project, it uploads what's already in this folder, so build with your framework's own tooling first.
By default, wix.config.json expects your build output in ./dist:
If your framework builds to a different folder, update the path before you release. For a static site with no build step, where index.html sits at the root of your project, use ".".
To deploy server code as well, set outputDirectory to an object with client and server paths instead of a single string. You can provide either or both:
Wix deploys and runs the server files as long as they're built for the Cloudflare Workers runtime. Inside that constraint, you can deploy:
wix.config.json, and relative fetch calls from the client to the backend.Frameworks whose server output can't run on Cloudflare Workers aren't supported. For more information, see About Supported Frameworks.
Note: Server code is only available when you initialize your project from your terminal. Uploaded sites and Claude Designs are static, so they use the single-string form.
Last updated: 30 July 2026