Shuttle opens inside your Shopify admin. Sometimes it can show an empty page, a message asking you to refresh your session, or a message that a page could not load. This article explains what each one means and what to do.
Shuttle's page stays empty after "Loading dashboard"
An empty page after the "Loading dashboard" screen means Shuttle's files did not reach your browser. Shuttle shows the "Loading dashboard" screen while it starts up. If that screen goes away and nothing appears, the app could not load.
Reload the page.
If the page is still empty, a browser extension, such as an ad or script blocker, may be stopping the files. A network filter, for example on a work network or a VPN, can do the same. Make sure cdn.shopify.com and Shuttle's own files are not blocked. You can allow them or pause the blocker.
Reload the page again.
"Your session needs a quick refresh."
The message "Your session needs a quick refresh." means Shuttle's login session has expired, or your browser did not keep it. Usually Shuttle fixes this by itself. It sends your whole tab back to Shopify admin and then reopens the Shuttle page you were on.
If your browser does not let Shuttle do that, you see the message with a Continue to Shopify admin button instead.
Click Continue to Shopify admin.
Shopify admin reloads and gives Shuttle a new session. Then the same Shuttle page opens again.
If Shuttle shows "Your session expired. Please reload the page to reconnect." instead, reload the page to start a new session.
"Could not load this page" or "Could not open this page"
The messages "Could not load this page" and "Could not open this page" mean a Shuttle page still could not load after Shuttle had already tried once. If a page's files fail to load, for example while Shuttle is being updated, Shuttle reloads that page by itself one time. If that also fails, or the page cannot open for another reason, you see one of these messages:
"Could not load this page. Please reload and try again." while Shuttle is starting up
"Could not open this page. Please reload and try again." when you move to another page in Shuttle
Reload the page. If the message keeps coming back, check that no browser extension or network filter is blocking Shuttle's files.
Open Shuttle from your Shopify admin, not from a bookmark
Open Shuttle from the apps list in your Shopify admin. This gives Shuttle a fresh session every time. A bookmark or saved link to a Shuttle page does not bring that fresh session from Shopify. So instead of opening the page straight away, it may take you to a sign-in step or back to Shopify admin first.