// troubleshooting guide · defold
Defold HTML5 Sound Not Playing
- Status
- Workaround available
- platforms:
- HTML5
- updated:
- November 18, 2026
- reports:
- 4
- Method
- how we research
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
FIX 1Add a start screen
- 01Show a click or tap to start screen before the game
- 02Start music on that input
Did this fix it?FIX 2Play on first input
- 01Trigger sound in on_input after the first touch or click
Did this fix it?FIX 3Test on real iOS
- 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 usOther Defold errors
- Defold HTML5 Build Black Screen
- Defold Android Bundle Error (Keystore)
- Defold iOS Provisioning Profile Error
- Defold Native Extension Build Error
- Defold Editor Crashes or Java Heap Space Error
- Defold Editor Wayland Tiny UI on Linux
- Defold HTML5 Game Slow on Mobile
- Defold Lua Error: Attempt to Index a Nil Value