What You Can Upload

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

Wix loads the project's site scripts on an uploaded site, including analytics, cookie consent, the favicon, and SEO tags from the dashboard. Wix adds those SEO tags in the browser.

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

Wix accepts the extensions below. HEIC, HEIF, and TIFF are pass-through images, and .bin is the external geometry a .gltf file references.

Type	Extensions
Markup	html, htm
Styles	css
Scripts	js, mjs, cjs, jsx, map
Images	png, jpg, jpeg, gif, svg, webp, ico, avif, bmp
Pass-through images	heic, heif, tiff
Video	mp4, webm, ogv
Audio	mp3, wav, ogg, m4a
Fonts	woff, woff2, ttf, otf, eot
Data and config	json, xml, txt, md
Documents and data	pdf, csv, yaml
Geo	geojson
3D	glb, gltf, bin

Wix rejects any other file type, such as WebAssembly, and ignores operating system and editor metadata, such as .DS_Store.

Size limits

• Up to 20 MB per file.
• Up to 20 MB in total.
• Up to 5,000 files.

See also

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