A frame is a dependency you do not control

If your page loads someone else's game in an iframe, you have inherited a set of failure modes that have nothing to do with your own code. The page looks empty, the player sees a blank rectangle, and the useful question changes from "what did I break" to "which of the four usual causes is this".

The four usual causes, in the order they are worth checking:

  • The host refuses to be framed. A response header such as X-Frame-Options or a frame-ancestors Content-Security-Policy directive will silently stop your frame from rendering anything.
  • Third-party cookies are blocked. The embedded game may be signed in, or may be storing progress, and a browser or extension that blocks third-party cookies breaks it in a way that looks like a broken game.
  • A content blocker eats the scripts. An extension that blocks the ad and analytics hosts can also block the bundle, and the failure only shows on the machines of people who have those extensions installed.
  • A stale bundle. If the host deploys often, a cached copy of the page can ask for an asset hash that no longer exists, and the frame renders a blank error instead of the game.

The last one is the nastiest because it is time-dependent: it works on your machine, it works for most people, and it fails for a small slice of players for a few hours after each deploy.

What a support page should actually do

The useful support page is not a troubleshooting essay. It asks two questions that narrow the cause immediately: which browser, and which device. Then it gives the player the one thing they cannot get from you, which is the upstream site itself, and it is honest about the boundary between what you can fix and what you cannot.

Being explicit about that boundary is not a cop-out. If the frame is blocked by a header on the other side, no amount of advice on your page will unblock it, and pretending otherwise sends people in circles. The honest version of daily orbs not loading says what the reader can try, says which cases are upstream, and gives them somewhere to go.