I’m working on a shopify embedded app using app bridge v4
This app provides an app theme extension.
When a store first installs the app the ui provides a link that when clicked should take them directly to the app embeds section of their theme settings so that they can easily enable the theme app extensions.
I used to use a URL such as:
https://admin.shopify.com/store/karls-secret-store/12345667/editor?context=apps
and it worked, however recently it seems to have stopped working and instead takes you to the top level theme settings page.
Can anyone point me to the correct way to do this?
Hi @kmeister ,
To link directly to your app embed in the Shopify theme editor:
Use this URL format:
https://admin.shopify.com/store/{store_handle}/themes/{theme_id}/editor?target=app:{app_handle}
Example:
https://admin.shopify.com/store/karls-secret-store/themes/12345667/editor?target=app:my-app
Replace:
- {store_handle} with the store’s handle (e.g., karls-secret-store)
- {theme_id} with the current live theme’s ID
- {app_handle} with your app extension’s handle (from extension.config.yml)
This takes users directly to the App Embeds section in the theme editor.
Thanks
Thanks Steven, unfortunately that doesn’t seem to work.
There are two considerations here:
First, shopify’s documentation around creating a deep link to install/enable an app theme extension.
I’ve found several different methods described for how to do so across forums, blogs and the official shopify docs. None of those approaches work for me.
They either just take me to the theme editor or they take me to the theme editor and attempt to add the ‘sign in with shop’ app
This one used to work and took me directly to the app embeds section of the theme editor but no longer does so
/admin/themes/current/editor?context=apps
This one is based on the docs and takes me to the sections area of the theme editor and adds the ‘sign in with shop’ app
/admin/themes/current/editor?template=&addAppBlockId={client_id found in your app’s toml file}/{The filename of the block’s Liquid file}/&target=newAppsSection
It’s entirely possible I’m doing this wrong.
Second, my original question was how can I create a link that would take the user directly to the app embeds section of the theme editor so that they can view the available app embeds and then enable/disable them.
The reason for wanting to do this is that the feedback I was given on a recent app submission specifically requested that we do that.
Here’s the feedback:
We also attempted to click the provided deep link, but we were redirected to the theme editor settings page instead of the specific page where the app embed is enabled and can be previewed. Ensure to provide detailed instructions or a deep link that redirects to the theme editor specific page where the app embed is enabled and can be previewed
A friend just pointed out this post from yesterday
I think what I’m reporting here could possibly be a dupe of that.
Hi @kmeister ,
Completely understand the confusion here. Shopify’s approach to deep linking into the theme editor has been inconsistent lately, and what used to work is no longer reliable due to backend changes or documentation gaps.
You’re right:
-
The /admin/themes/current/editor?context=apps link previously opened the app embeds section directly, but it seems Shopify may have deprecated or altered this behavior.
-
The newer method using addAppBlockId often redirects incorrectly or triggers an unrelated app block, which clearly isn’t helpful.
Unfortunately, as of now, there’s no guaranteed stable way to deep-link directly to the App Embeds section specifically at least not one that’s officially documented and working consistently across stores.
That said, the best workaround I can suggest is guiding users manually:
-
Go to Online Store > Themes > Customize (your current live theme).
-
From the theme editor, click the App Embeds icon (the puzzle piece in the left-hand sidebar).
-
Enable your app embed from there.
Thanks
Here’s the thread where it was confirmed to be a shopify platform issue
