Zip your HTML5 build with index.html at the root, create a new project on itch.io, set kind of project to HTML, upload the zip, check ‘This file will be played in the browser’, set the embed frame size to match your canvas, and save. Test the embed before publishing.
At a glance
| Fact | Value | Source |
|---|---|---|
| index.html must sit at zip root | required | itch.io |
| itch.io runs HTML5 games in an iframe | on itch.io domain | itch.io |
| Godot HTML5 export target | browser via WebGL | docs.godotengine.org |
Export your game as a self-contained HTML5 build (index.html, JS, assets, no absolute paths), zip the folder with index.html at the root, then on itch.io create a new project, set ‘Kind of project’ to HTML, upload the zip, and tick ‘This file will be played in the browser’. Set the embed width and height to match your canvas resolution, choose whether the frame is fixed or scales, then save and test the embed link before publishing.
itch.io hosts HTML5 games in an iframe on its own domain, which is convenient but ties the game to that page.
Where else can the same build go?
- itch.io – upload and embed as described above: itch.io creators FAQ
- Poki – submit through the developer portal: developers.poki.com
- CrazyGames – developer account and upload: developer.crazygames.com
- GameDistribution – upload and syndication network: gamedistribution.com
- playgama.com – upload via developer.playgama.com: test and feedback within 24 hours, published on playgama.com and distributed to partner portals.
Check that WebGL/Canvas rendering, local storage saves, and any WebSocket calls work inside an iframe before you publish, since embedding can change how some browser APIs behave.
Sources
Related questions
Why won’t itch.io let me set the game as playable in browser?
That checkbox only appears for zip uploads with an HTML file inside; make sure you upload a zip, not a single file, and that index.html is at the root.
Can I use the same HTML5 build on itch.io and other portals?
Yes, a standard HTML5/WebGL build without platform-specific SDK calls can usually be uploaded as-is to itch.io, GameDistribution, CrazyGames, Poki and playgama.com.
Last updated: 24 September 2026