❗️Shopify Embedded App – White Screen & 401 Unauthorized Until Session is Deleted

Hi everyone,

I’m running into a critical issue with my Shopify embedded app in production. Some users report that the app does not load and instead shows a completely white screen.

When inspecting the browser console, we consistently see this error:

Failed to load resource: the server responded with a status of 401 ()

more details:

  • The app is embedded using Shopify App Bridge.

  • This issue happens randomly for some stores.

  • The URL contains the expected query parameters like hmac, shop, session, and id_token.

  • The backend returns a 401 Unauthorized, and the frontend stays stuck on a white screen.

what i tried:

  • The only thing that fixes it is manually deleting the session from the database — after that, the app loads normally again.

What could cause a valid session to suddenly result in a 401 Unauthorized, and why does deleting the session make the app work again?

Thanks in advance for any help or guidance!