Asset API Access Transition To Theme App Extensions

Shopify Apps
,

Topic summary

Shopify is deprecating direct theme edits via the Assets API; an SEO app that injects a Google meta tag and Google Tag Manager (GTM) script into the asks if a Theme App Extension is required.

  • Recommended action: Migrate to a Theme App Extension using an App Embed Block with target set to “head”.
  • Rationale: Theme app extensions are automatically removed on app uninstall, preventing leftover code and improving merchant experience.

Clarifications addressed:

  • Even if meta tags are static across all pages, the extension approach is still required as part of Shopify’s direction.
  • Another SEO app reports successfully migrating and injecting JSON-LD (structured data) via an extension.

Timeline and impact:

  • Deadline referenced: December 31, 2023. Consequence is not definitively stated; it’s suspected that Asset API calls to modify theme assets will fail afterward. Verification with Shopify support is advised.

Status:

  • Action item: Implement a theme app extension (App Embed Block targeting “head”).
  • Open question: Exact behavior of the Assets API after the deadline remains unconfirmed and should be validated with Shopify support.
Summarized with AI on January 12. AI used: gpt-5.
1

I have a live Shopify app. I am seeing the below message in the API Health section of the app.

Shopify Partners 2023-11-21 00-43-26.png
Shopify Partners 2023-11-21 00-43-26.png1029×611 40.7 KB

My app uses Assets API to insert Google meta tag and Google Tag Manager (GTM) script tag to the section of client’s website. In this case do I need to create a theme extension for the app?

The app is an SEO app. There is no UX blocks added by the app.

Thanks in advance.

2

Hi @user072319 ,

Yes, you need to transition to an App Extension and set the target to “head”.

See: https://shopify.dev/docs/apps/online-store/theme-app-extensions/extensions-framework#app-embed-blocks

Our Strong SEO app inserts JSON-LD code into websites and we’ve had to do this too. Once you understand how it works, it’s not too hard and the experience for the merchants is improved.

Lee

3

Hi @Lee-Strong-SEO ,

Thanks for the response.

Still confused. The meta tags added by our app are static to all pages. Then what is the need for theme extension?

Do you know what will happen if we don’t create theme extension by 2023 December 31st. Will the app stops working?

4

The theme extension prevents your code from remaining on merchants sites when they uninstall your app. Theme app extensions are automatically removed when the app is uninstalled.

Regardless of the reasons, this is the way Shopify are going, so we all need to adapt to it. If you don’t update in time, I suspect that your API calls to change theme assets will fail, but you might want to check that with Shopify support.