NotAllowedError: play() failed because the user didn't interact with the document first.
The browser blocked media autoplay with sound until the user interacts with the page.
Exact message you may see
play() failed because the user didn't interact with the document firstThe play() request was interrupted
Seen on:
JavaScript
Meaning
Autoplay policies allow muted autoplay but require a user gesture for sound. video.play() returns a rejected promise.
Common causes
- Calling play() with sound on page load
- Audio started from a timer, not a click
⚡ Quick fix
- Start playback from a click/tap handler
- Autoplay muted (muted + playsinline) and offer an unmute button
- Catch the play() promise rejection
Detailed fix by platform
JavaScript
- javascript
video.muted = true; video.play().catch(() => showPlayButton());
How to diagnose
- Trigger — Was play() called from a user gesture?
- Sound — Muted?
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
Most viewed in JavaScript
Other ways to find it
Where this error sits
Origin: On your device. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Did this fix work for you?
Report a correction or suggest an improvement
Last updated 9 Oct 2026