// troubleshooting guide · defold

Defold HTML5 Sound Not Playing

Status
Workaround available
platforms:
HTML5
updated:
November 18, 2026
reports:
4
Method
how we research
Share

RUNBOOK · defold/html5-sound-not-playing3 FIXES

// quick answer

Browsers block audio until the user interacts with the page, so Defold web builds stay silent at start. Add a click-to-start screen.

Most likely fix: Add a start screen

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Add a start screen

    1. 01Show a click or tap to start screen before the game
    2. 02Start music on that input
    Did this fix it?
  2. FIX 2Play on first input

    1. 01Trigger sound in on_input after the first touch or click
    Did this fix it?
  3. FIX 3Test on real iOS

    1. 01Test on iOS Safari because Android Chrome behaves differently
    Did this fix it?

SANDBOX · defold RUNS IN YOUR BROWSER

Try it: open a 3D scene, render it and export a build

A hands-on Defold-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

Music or sound does not play in Chrome or iOS Safari until the screen is clicked.

Why it happens

  • C-01Browser autoplay policy
  • C-02AudioContext not resumed after a user gesture
  • C-03iOS Safari restrictions

// this guide also covers

  • defold html5 no sound
  • defold audio autoplay
  • defold ios safari sound

Still not working?

If Defold keeps failing, you're not alone. See every Defold 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 Defold Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Defold errors

All 11 Defold errors and fixes →