Skip to main content
Back to changelog

Script tags are deprecated and will stop running on March 1, 2027

Starting October 1, 2026, the scriptTagCreate and scriptTagUpdate mutations will return an user error, and the ScriptTag REST Admin API resource will reject POST and PUT. The deprecation applies to all API versions, including older ones, so pinning won't defer it.

On March 1, 2027, Shopify will stop injecting script tags into storefronts. Storefronts are the last place script tags still run, since they already stopped working on the Order status page. If your app uses a script tag to load JavaScript onto a store, then you need to replace it before then.

What's changing

A script tag loads JavaScript on a storefront without any changes to theme code. After March 1, 2027, Shopify won't inject those scripts, so script tags will stop loading JavaScript on storefronts.

The scriptTags query and the scriptTagDelete mutation keep working, so you can audit and clean up your existing script tags.

What you need to do

Replace each script tag with an app embed block, which you ship in a theme app extension. App users activate app embed blocks in the theme editor.

If a script only collects analytics or conversion data, then use a web pixel instead, which needs no action from the app user.

Who's affected

Apps that create script tags with a display_scope of online_store.

Script tags with a display_scope of order_status are covered by an earlier deprecation. Refer to Order status script tags.

Deprecation timeline

  • October 1, 2026: scriptTagCreate and scriptTagUpdate will return an user error. Existing script tags will keep running.
  • March 1, 2027: Shopify will stop injecting script tags into storefronts.

Migration path

App embed blocks replace script tags, and you ship them in a theme app extension. Refer to Storefront script tags to learn more.

Related docs

Was this page helpful?