Fixing YouTube Error 153 in embedded players

Browsers normally send the Referer for you, so error 153 on a web page usually means something removes it. Check for a Referrer-Policy: no-referrer header or meta tag, a referrerpolicy="no-referrer" attribute on the iframe, or a player opened with window.open and the noreferrer feature. YouTube recommends strict-origin-when-cross-origin, which is already the default in many browsers.

A WebView sends no Referer by default, which is why apps hit 153 most often. Player inside a bundled HTML file: pass a base URL when you load it, loadDataWithBaseURL on Android or loadHTMLString:baseURL: on iOS. Loading https://www.youtube.com/embed/VIDEO_ID directly: add a Referer header, through the additionalHttpHeaders map of loadUrl on Android or on the URLRequest you pass to WKWebView.load on iOS. Android Custom Tabs: put Intent.EXTRA_REFERRER on the intent with an android-app:// URI of your package name. SFSafariViewController can’t set a Referer, so set the origin player parameter instead. In each case the value is an HTTPS URL whose domain is your store app ID, for example https://com.example.app; Apple platforms use the bundle ID. On macOS follow the iOS steps; on Windows set the header through HttpRequestHeaders.Referrer or CoreWebView2HttpRequestHeaders.SetHeader.

If you embed YouTube through a package such as a Flutter or React Native player plugin, the fix belongs in how that package loads the player. YouTube’s policy says owners of such libraries must read the app ID from the environment where possible, or let developers pass it in, and then set the Referer and, where appropriate, the widget_referrer player parameter. So update the package first and look for an option to pass your app ID or a base URL; if there is none, check its issue tracker before patching it yourself. While you’re updating dependencies, see Flutter 3.47 and React Native 0.87.

Video that plays keeps people in your app; being found brings them there. Censuus ranks apps by the visits they draw, and adding your app is free through the List my app form. Placement comes from traffic and sponsorship: apps climb on the visits they draw, and a sponsor can pay to rise higher. For store videos rather than embeds, see App Store preview video specs.