App Failed to Load

If Shopify POS shows an “App failed to load” message when you open the POS Cafe tile, the steps below usually get it loading again.

What’s Causing This?

The message comes from the Shopify POS app, not from POS Cafe: it means Shopify POS couldn’t start the app it was asked to open, and it can affect any POS app. Shopify has fixed the platform problem that once caused this widely, but a device can still run into it now and then, and the same steps clear it.

Steps to fix it

1. Update the Shopify POS app to the latest version: How to update apps on iPad
2. Update your iPad’s operating system: How to update iPadOS
3. Force close the Shopify POS app, then re-open it: Watch: How to force close apps on iPad
4. Restart your iPad completely.
5. Sign out of the Shopify POS app, then sign back in.

Note

Work through the steps in order and try the POS Cafe tile after each one. If it still won’t load after all five, send us a message with the device and Shopify POS version and we’ll help, including raising it with Shopify support if needed.

How to Force Close the Shopify POS App

Force closing is step 3 above and fixes most cases on its own. Here is how to do it on each device.

Note

If the POS Cafe tile opens but shows License required, the app has loaded correctly: this location doesn’t have an active POS Cafe license. Activate a license for the location in Shopify admin under Apps → POS Cafe → Locations.

On iPad / iPhone (iOS)

1. Swipe up from the bottom of the screen (or double-press the Home button) to open the app switcher.
2. Find the Shopify POS app.
3. Swipe it up off the top of the screen to force close it.
4. Reopen Shopify POS and try loading the POS Cafe tile again.

On Android

1. Tap the Recent apps button (usually a square or three-line icon), or swipe up from the bottom and hold to open recent apps.
2. Find the Shopify POS app.
3. Swipe it up or off the side of the screen to close it.
4. Reopen Shopify POS and try loading the POS Cafe tile again.

Please do not hesitate to reach out if you have any questions or need help.