What You Can Upload

When you upload a site to create a Wix-managed headless project, Wix serves your files as they are and doesn't build them. This article lists what the upload accepts.

Upload your build output, not your source

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.

Requirements

What you upload must be:

• 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.

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.

Size limits

• Up to 3MB per file.
• Up to 20MB in total.

See also

• Upload a Static Site
• About Supported Frameworks
• The wix.config.json File