Skip to main content

WebGL build structure

The zip must contain index.html and a *.loader.js file:
A single wrapping folder is fine — if Unity exports to WebGLBuild/, the upload strips that prefix for you. What fails is a zip with several top-level folders and no index.html inside any single one. __MACOSX/ and ._ entries created by macOS are ignored automatically.
Missing either index.html or a *.loader.js file is rejected with Invalid build: missing index.html or loader file.

Archive limits

These are checked before extraction, so an oversized build fails fast rather than part-way.

Upload via Developer Portal

  1. Developer Portal → your game → Builds → Upload Build
  2. Select platform (WebGL, iOS, Android)
  3. Set version ID — use semantic versioning (1.0.0) or dates (2026-08-01)
  4. Add release notes — describe what changed and how to test
  5. Upload zip

Upload via CI/CD

Use the developer API key:

Version states

A passing review moves a version straight to live. There is no separate approved-but-not-live state.

Release notes checklist

Good release notes help reviewers pass builds faster:
  • What changed since last version
  • Known issues or workarounds
  • Test account credentials if auth is required
  • Which platforms were tested