POS Ui Extension stuck on Loading

Hi team,

We have a custom POS UI Extension that generally loads without any issues during the week. However, we’ve noticed that, typically on weekends, there are occasional cases where the extension remains stuck on “Loading…” indefinitely.

When this occurs, none of the extension content is rendered. Because the extension never appears to initialize, my assumption is that the issue may not be within the extension code itself. I also considered a connectivity problem, but the fact that the Shopify POS app continues to function normally during these incidents makes that seem less likely.

Shopify Support suggested enabling runs_offline = true so that the extension can attempt to load regardless of network connectivity. While that could help, the extension still relies on a network request after mounting, so we would need to handle any communication failures separately. One potential benefit of this approach is that each time the extension attempts to mount, it would also retry the network request, which seems preferable to requiring the user to completely restart the POS app.

Has anyone encountered a similar issue with POS UI Extensions? If so, what approach did you take to troubleshoot it? Is there a recommended way to trigger or force the extension to reload when it gets stuck in the loading state?

Thank you in advance for any insights.

Hi, could you share the following details, either here if you’re comfortable or through a support ticket?

  • App ID / API client ID
  • Extension registration UUID, if available
  • Shop ID/domain
  • POS app version and platform
  • Device model
  • Approximate timestamp and timezone when it happened
  • Have you checked the POS > Support > Diagnostics screen to determine connectivity issue?
  • Whether force-closing and reopening POS clears the loading state
  • Whether this happens only after the device has been idle/backgrounded, or also on a fresh POS launch

Those details will let us correlate the report with our metrics. Thanks!

Hi,

I could share that via ticket. How can I open a ticket with the dev team?

Regards,

Rodrigo

I would connect the debugger and see what’s happening as it might be a request you are making that’s hanging or some bad state etc