// 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
Share

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

  1. FIX 1Fix the zip layout

    1. 01Zip the contents of the export folder, not the folder itself
    2. 02Make sure index.html is at the zip root
    3. 03Re-upload
    Did this fix it?
  2. FIX 2Read the browser console

    1. 01Open developer tools in the browser (F12)
    2. 02Check Console and Network for missing files or errors
    Did this fix it?
  3. FIX 3Adjust the itch.io embed

    1. 01Edit the game page embed options
    2. 02Try the fullscreen setting, as users report the game not starting otherwise
    3. 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 us

Watch GameMaker Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All crashes, freezes & blank screens guides →

Other GameMaker errors

All 10 GameMaker errors and fixes →