Intermittent Blank Page Issue While Redirecting to Theme App Editor Using addAppBlockId Deep Link

Built for Shopify
1

Hi Shopify Community,

We are facing an intermittent issue while redirecting merchants from our Shopify embedded app dashboard to the Theme App Editor using the addAppBlockId deep link.

We have added a button inside our embedded app dashboard, and on button click we redirect the merchant to the Theme Editor to automatically enable the Theme App Extension block.

We are using the following deep link format:
https://{shop}/admin/themes/{themeId}/editor?addAppBlockId={blockId}/{blockHandle}&target=newAppsSection&template={template}

Issue

The behavior is inconsistent:

  • Sometimes the redirect works correctly.
  • Many times, the Theme Editor opens a completely blank page.
  • In the blank page case, no loader or content is displayed.
  • If we manually reload the page, the Theme Editor loads correctly and the app block flow works as expected.

Screenshot:

image
image1920×961 3.84 KB

Additional Details

  • This issue occurs randomly and is difficult to reproduce consistently.
  • We are triggering the redirect from inside a Shopify embedded app.
  • The issue has been observed across multiple stores/themes.

Questions

  1. Has anyone else faced a similar issue with Theme Editor deep links?
  2. Is there any recommended way to handle or stabilize redirects to the Theme Editor?
  3. Are there any known limitations or timing issues with the addAppBlockId flow?

Any suggestions or guidance would be appreciated.

Thanks!

2

When you manually reload the blank Theme Editor page, does it redirect correctly into the app block insertion flow (addAppBlockId target section), or does it only open the normal Theme Editor without focusing the app block section?

3

@Amwhiz_Media On manually reload it redirect correctly into the app block insertion flow.

4

We have also faced similar behavior while redirecting from an embedded app to the Theme App Editor using the addAppBlockId deep link.

In our app, we are using the following redirect format:

const themeEditorUrl =
  `https://${shopDomain}/admin/themes/current/editor` +
  `?template=product` +
  `&addAppBlockId=${apiKey}/${blockName}` +
  `&target=mainSection`;

After switching to this format, we have not faced the issue again and the redirect flow has been working fine for us.

You can try using the same approach and check whether it resolves the issue on your side as well. If the issue still persists, then it may be related to Theme Editor initialization timing from the embedded app context rather than the deep link structure itself.

5

Hi @Amwhiz_Media, Thanks for your response on this.

I tried the solution you mentioned, but I’m still facing the same issue. During redirection, a blank screen is displayed, but after reloading the page, it works perfectly.

After reloading the page multiple times, the redirection flow starts working properly for some time, but after a while, the same issue occurs again. Then, after refreshing the tab several times, the redirection flow starts working correctly again.

6

Since the issue starts working again temporarily after multiple refreshes, it might also be worth checking whether this is related to browser cache/state or local development build inconsistencies.

A few things you could try:

  • Clear the browser cache and cookies for the Shopify admin domain
  • Test the flow in an incognito/private window
  • Try a different browser entirely to rule out browser-specific caching behavior
  • If you are testing locally, ensure the latest changes are properly rebuilt/restarted (npm run build, fresh dev server restart, etc.)
  • Verify that no stale embedded app session or old assets are being cached during the redirect flow

We have seen cases where embedded app redirects behave inconsistently because of cached admin/app state, especially during active development iterations.

7

Hi @Amwhiz_Media ,
We have already tried clearing the cache, using incognito/private mode, and testing in different browsers such as Chrome and Firefox, but we are still facing the same issue.

8

I’m also experiencing a blank page issue that I can’t reliably reproduce. We tried several methods (incognito, browser switch, deep link format and params) which most of the time ends up on a blank page. Navigating via App Bridge Redirect.Action.ADMIN_PATH is more reliable but exits merchant from the embedded app into /themes on return, creating poor UX.

Is this a known issue? Any tips appreciated.