Deep link sometime leads to the wrong app block

Shopify Apps

Topic summary

Developers are experiencing a bug with Shopify theme extension deep links that use the addAppBlockId parameter to target specific app blocks.

The Problem:

  • Deep links intended to open a specific app block (e.g., some-player) frequently open the wrong block instead (typically first-player or the first app block in the list)
  • The issue is intermittent—the correct block opens approximately 2 out of 10 times, despite using identical URLs
  • The problem can be reproduced by repeatedly entering the same deep link

Technical Details:

  • Developers are using the correct format: https://store.myshopify.com/admin/themes/current/editor?addAppBlockId=<uuid>/block-handle&target=newAppsSection
  • Each app block has a unique handle, sharing the same UUID (which aligns with Shopify documentation)

Current Status:

  • Multiple developers have confirmed experiencing the same issue
  • Suggested workarounds (checking UUID uniqueness, renaming blocks, reviewing related forum threads) have not resolved the problem
  • The discussion remains unresolved with no official Shopify response to the bug report
Summarized with AI on October 26. AI used: claude-sonnet-4-5-20250929.
1

Hello. I have a theme extension with 4 app blocks. For every block, I created a separate deep link like
https://store.myshopify.com/admin/themes/current/editor?addAppBlockId=/some-player&target=newAppsSection

The problem is that very often that link leads to the first app block in the app list with another name. For example, I want to see the app block some-player, but the first-player app block is opened. But 2 times from 10, the correct some-player app block is opened correctly, and the deep link is the same all the time.

It can be reproduced by just entering the same deep link into the browser repeatedly.

Is it a bug or something else?

2 Likes
2

Hey,

Have you tried checking each block’s UUID is unique and not overlapping?

Try renaming blocks with unique names. May be it can help!

3

The UUID is one for all app blocks, and it’s correct according to the shopify docs. But a handle for each app block is unique. Like

addAppBlockId=/some-player
addAppBlockId=/first-player
addAppBlockId=/other-block

4

Did you find any solution? I am facing the same issue

1 Like
5

Check this - may be it can help!

https://community.shopify.dev/t/error-in-a-deep-link-for-adding-app-block-extension/2659

https://community.shopify.dev/t/deeplinking-of-app-blocks-sometimes-adds-a-wrong-app-block-to-the-page/12110

6

Hello, We are also facing the same issue. Where different app block is getting added.

7

Thank you. But that didn’t help.

8

@Shopify_77 Are you going to fix that bug?

3 Likes
9

Thank you very much, we also encountered such a problem. Through your description, we know that this is a deep link failure.

1 Like
10

I have the same issue. It just loads the app block from the first app inside “Apps” section, almost every time…