Export and package a build
The exact ZIP limits and runtime structure enforced by the upload implementation.
Downloads for this guide
Valid HTML5 runtime ZIPA real root-index package, ready for the current package validator.Required layout
game.zip
index.html ← exact lowercase name, at archive root
game.js
assets/
sprites.png
sound.ogg
engine.wasm ← if your engine needs it
engine.pck ← Godot export, if applicableZIP the contents of the build directory, not the containing folder. Keep relative asset paths and case consistent. Include a head tag in index.html for SDK injection. Native project source, Unity Assets/ProjectSettings and Godot project.godot are not runtime submission packages.
Enforced package limits
| Check | Current implementation |
|---|---|
| ZIP buffer | At most 100 × 1024 × 1024 bytes |
| Expanded size | At most 500 × 1024 × 1024 bytes |
| Entries | At most 2000, including directory entries |
| Entrypoint | Exact root index.html |
| Paths | No backslashes, NUL, absolute paths, colon-containing segments, . or .. segments |
| Duplicates | Rejected case-insensitively |
| Links and encryption | Symlinks and encrypted entries rejected |
| Extensions | Allowlist below, case-insensitive |
The request gateway may impose additional deployment transport limits; these numbers describe the repository's package validator. A successful ZIP extraction is not malware, gameplay or browser certification.
Allowed extensions
html htm css js mjs json xml txt map png jpg jpeg gif webp svg ico mp3 ogg wav m4a aac flac mp4 webm ogv woff woff2 ttf otf eot wasm pck data bin atlas csvThis list is generated from the package implementation. .cs, .gd, .tscn, .godot, .md, .br, .gz and .unityweb are not allowed in a game upload. Downloadable source packages intentionally include native project files; export them first. The HTML5 upload ZIP contains only runtime files.
Common export errors
- 'Package requires index.html at its root': remove the extra wrapper folder or rename the exported entrypoint correctly.
- 'Unsupported package file type': remove native/source files; disable unsupported compression; keep required runtime assets in accepted formats.
- 'Duplicate package path': resolve case collisions before zipping.
- 'Unsafe package path': package a clean relative build tree without symlinks or traversal entries.
- Missing scripts/wasm/pck: include every referenced file and check case-sensitive paths.
Prepare for upload
Test a fresh extracted copy rather than a browser cache of the engine dev server. Ensure the archive contains no credentials, local environment files, editor caches, node_modules or private data. Use the submission checklist for metadata and cover assets.