// troubleshooting guide · gamemaker
GameMaker HTML5 Game Black Screen
- Status
- Workaround available
- platforms:
- Web, itch.io
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · gamemaker/html5-black-screen3 FIXES
// quick answer
A blank or stuck web build usually comes from a wrong zip layout, a missing file, or embed settings on the host. Put index.html at the zip root and read the browser console.
Most likely fix: Fix the zip layout
How to fix it
// try these in order, the most common fix is first
FIX 1Fix the zip layout
- 01Zip the contents of the export folder, not the folder itself
- 02Make sure index.html is at the zip root
- 03Re-upload
Did this fix it?FIX 2Read the browser console
- 01Open developer tools in the browser (F12)
- 02Check Console and Network for missing files or errors
Did this fix it?FIX 3Adjust the itch.io embed
- 01Edit the game page embed options
- 02Try the fullscreen setting, as users report the game not starting otherwise
- 03Consider the WASM export, which users say fixes several HTML issues
Did this fix it?
SANDBOX · gamemaker RUNS IN YOUR BROWSER
Try it: open a 3D scene, render it and export a build
A hands-on GameMaker-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
The game runs in the IDE but shows a black or empty page, or loads and stops, on itch.io or your own server.
Why it happens
- C-01index.html nested inside a folder in the zip
- C-02Missing files or wrong MIME types on the host
- C-03Fullscreen embed setting on itch.io
- C-04Runner crash before first render
// this guide also covers
- gamemaker html5 black screen
- gamemaker itch.io blank screen
- gamemaker html5 not loading
Still not working?
If GameMaker keeps failing, you're not alone. See every GameMaker problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
All crashes, freezes & blank screens guides →
Godot 4 Crashes on Startup: Vulkan Device Errors (Godot)
Unity Hub Not Opening (Unity)
Unreal Engine Fatal Error Crash (Unreal Engine)
Other GameMaker errors
- GameMaker YYC Compile Error
- GameMaker Android Build Failed
- GameMaker IDE Slow or Freezing
- GameMaker Game Crashes on Startup
- Why Is My GameMaker Game Lagging
- GameMaker Commercial Licence: Can I Sell My Game?
- GameMaker Creator and Indie Subscription Not Renewing
- GameMaker GMRT Runtime: What Changes and Do I Need to Switch