Quick Start by Uploading Your Site

Upload a static site you already built and deploy it as a Wix-managed headless project. Wix hosts and runs your site and connects it to Wix business solutions. There's nothing to install and no terminal required.

Your site gets:

• Managed hosting on a global CDN with automatic SSL.
• A management dashboard for your business data.
• Access to Wix's robust business APIs.

For more information, see About Wix-Managed Headless.

Before you begin

Wix serves your files as they are and doesn't build them. If your site has a build step, upload the output your framework produces, such as a dist folder, rather than your project source. Source files pass the upload but produce a site that doesn't run, because nothing bundles or compiles them.

Make sure what you upload is:

• Static. HTML, CSS, and client-side JavaScript only. Nothing runs on a server, so backends such as Express or Node servers, framework API routes, and server-rendered templates aren't deployed.

• Entered through an HTML file at the top level. A single HTML file works on its own. With more than one at the top level, name one of them index.html. Wix loads index.html first, so it's the safest name either way. HTML files nested only inside subfolders aren't accepted.

• Made up of supported file types:

  Type	Extensions
  Markup	html, htm
  Styles	css
  Scripts	js, mjs, cjs, jsx, map
  Images	png, jpg, jpeg, gif, svg, webp, ico, avif, bmp
  Fonts	woff, woff2, ttf, otf, eot
  Data	json, xml, txt, md

  Any other file type, such as video or WebAssembly, is rejected. Operating system and editor metadata, such as .DS_Store, is ignored automatically.

• Within the size limits. Up to 3MB per file, and 20MB in total.

You don't need to be logged in to upload, but you do need a Wix account to keep your site.

Step 1 | Upload your site

To upload your site:

1. Go to wix.com/headless/drop.

2. Drag your build output onto the drop zone, or select a folder or a zip file.

   This creates a wix.config.json file, uploads and hosts your files with SSL, CDN, and business APIs configured, and releases your site so it goes live on a *.wix-site-host.com URL.

3. Wait for the process to complete, then open the live URL from the success page to confirm your site is up.

4. Log in or sign up to save your site.

Step 2 | Set up your local project

Wix now holds the files you uploaded plus a generated wix.config.json file that links them to your Wix project. To keep developing, download that project and set up authentication with a Wix client.

Choose one of the following approaches.

Step 3 | Continue developing

After your project is set up, keep building:

• Develop with an AI agent. Point your agent at the Wix Headless skill to finish setup and integrate Wix business solutions.
• Manage business data in the dashboard. Manage products, bookings, blog posts, forms, members, and more directly from your project dashboard. No code required.
• Deploy updates with the CLI. Make changes in your local project, build with your framework's own tooling, and run npx wix release to publish them.
• Preview locally. Run npx wix preview to test your site locally. Along with release, these are the only project-level CLI commands available for this kind of project.

See also

• About Wix-Managed Headless
• Quick Start from Your Own Frontend
• About Authentication for Self-Managed Headless