Embedded You Tube videos suddenly stopped working in iOS mobile app

Google Workspace Developers Q&A
1

Starting last week, embedded YouTube videos in our iOS mobile app stopped working and now display the following error:

“Error 153 – Video player configuration error”

This issue only affects iOS. Our Android app continues to play embedded YouTube videos without any problems.

I’ve seen similar reports on Stack Overflow, but none of the suggested fixes work consistently. I’m also reviewing the YouTube Embedded Player API documentation to ensure compliance, but haven’t found a definitive solution yet.

My code:

<iframe class="embed-responsive-item rounded h-300px w-100 mb-5" 
    src=”https://www.youtube.com/embed/<video ref>?controls=0”

    referrerpolicy="strict-origin-when-cross-origin"

    allowfullscreen="allowfullscreen">

Questions:

Has anyone identified the root cause of this error on iOS?

Are there any official updates or configuration changes required for the YouTube Embedded Player API?

Any recommended workaround or best practice to restore functionality?

Additional Info:

No recent changes were made to our implementation before the issue started.

Any guidance or suggestions would be greatly appreciated!

3 Likes
2

Were you able to find a solution to this?

3

I’ve run into something similar recently while working on a small gameplay page where I embedded a short YouTube clip on my homepage. Everything worked fine on desktop and Android, but on iOS the video frame either showed an error or pushed the layout out of alignment. The strange part was that nothing had changed in my code before it started happening.

The only thing that helped temporarily was wrapping the iframe in a stricter responsive container and removing a couple of optional parameters until iOS stopped rejecting the player configuration. I also noticed that referrer rules can behave differently on iOS, so adjusting that part may be worth testing.

During that testing phase I kept a reference build of the app I was working with here: (URL Removed by Staff) mainly so I could check how the page behaved with different assets loaded. If the frame is sensitive to layout shifts, even small UI elements can trigger that error on iOS.

It still seems like an underlying YouTube/iOS issue, but refining the iframe container and simplifying the embed parameters might help until an official fix appears.

4

This solution worked well as a quick fix:

https://medium.com/@davidvesely.cz/fixing-youtube-error-153-in-ios-capacitor-apps-a-simple-proxy-solution-5807d3df83d5