App Block Deep Linking Does Not Work When the Shop Language Setting Is Japanese

Retired Boards Appdev Store Design

Topic summary

Issue: App block deep linking to the theme editor works in English but fails when the shop’s language is set to Japanese.

Context:

  • Deep link format used: /admin/themes/current/editor?template=product&addAppBlockId=SHOPIFY_EXTENSION_NAME_ID/handle&target=mainSection.
  • Error appears only under Japanese language settings (screenshot provided, details not specified). Reference: Shopify docs on theme app extension deep links.

Proposed solution (community):

  • Use the block’s UUID (BLOCK_UUID) instead of the extension name ID in addAppBlockId.
  • How to obtain BLOCK_UUID after deployment:
    1. Online Store > Themes > Customize; add the app block and save.
    2. Edit code; find the block entry with type: “shopify://apps/APP/blocks/BLOCK_NAME/BLOCK_UUID”.

Status/updates:

  • Original poster confirmed the ID appears correct and notes the link works in English, suggesting the ID is likely not the cause.
  • Another participant asked if a solution was found; no confirmed fix shared.

Outcome: No resolution yet; cause remains unclear (possible localization-specific behavior). Discussion is open.

Summarized with AI on December 22. AI used: gpt-5.
2

I believe there is a typo. “SHOPIFY_EXTENSION_NAME_ID” should actually be replaced with “BLOCK_UUIID”.

The block ID is reported to be available only after the initial deployment. To acquire it again, please follow these steps:

  1. Go to Online Store > Themes > Customize.
  2. Add your app block to the theme.
  3. Save your changes.
  4. Click the kebab menu (…) next to the theme name.
  5. Select “Edit code”.
  6. Look for your app and block to obtain your BLOCK_UUID. It should appear as follows:
"type": "shopify://apps/YOUR_APP_NAME/blocks/BLOCK_NAME/BLOCK_UUID",
1 Like