# Shopify will stop storefront ScriptTags in March 2027 — new writes fail from October

Shopify is retiring the last remaining ScriptTag surface: apps lose the ability to create or update storefront script tags on October 1, 2026, and Shopify stops injecting existing tags on March 1, 2027. Apps need theme app embed blocks or web pixels instead.

The checkout ScriptTag shutdown already had an earlier deadline; this is the separate storefront cutoff. Pinning an old Admin API version will not preserve write access after October, and any feature still depending on an injected storefront script stops working in March.

- Status: Active
- Published: 2026-08-28T22:07:46+12:00
- Updated: 2026-08-28T22:07:46+12:00
- Categories: Web Development, Developer Tools
- Tags: migration, ScriptTags, Shopify, theme app extensions, web pixels
- Canonical HTML: https://beyondthe.news/dossiers/shopify-storefront-scripttag-deprecation-app-embed-web-pixel-2027

## What changed

Shopify published a separate retirement timeline for ScriptTags that still load JavaScript on storefront pages. From October 1, 2026, apps cannot create or update ScriptTags: GraphQL `scriptTagCreate` and `scriptTagUpdate` return permission errors on every API version, and REST POST/PUT operations fail as well. Existing storefront ScriptTags continue running temporarily and remain readable/deletable. On March 1, 2027, Shopify will stop injecting them into storefront pages entirely, so any feature that still depends on the remote script will stop working. Shopify directs app developers to app embed blocks in theme app extensions for storefront functionality and web pixels for analytics/conversion tracking.

## Why it matters

ScriptTags have been a long-lived way for Shopify apps and custom integrations to inject behavior into merchant storefronts without editing theme templates. The retirement is therefore a code-execution and distribution cutoff, not an API housekeeping change. App vendors must ship the replacement before October if new installations need the functionality, and must get existing merchants onto an enabled app embed or alternative before March. The migration also changes control semantics: app embed blocks are enabled per theme, so a merchant publishing a different theme can accidentally lose the replacement even after the app itself is installed.

## October removes the ability to create or change ScriptTags

Shopify says the October 1 write cutoff applies across every Admin API version. Pinning to an older version does not defer it. Existing ScriptTags keep running and can still be queried or deleted, but an app cannot create a new tag for a new installation or update the URL/configuration of an existing one. Apps that wait until after the cutoff therefore lose the old fallback path while trying to migrate customers.

## March is the actual storefront execution shutdown

On March 1, 2027, Shopify will stop injecting ScriptTags into storefront pages. The remote script no longer loads and any feature depending on it stops working for that store. This is distinct from the earlier Order status/Thank you page ScriptTag retirement that BTN already covers under the non-Plus checkout migration.

## The replacement is an app embed block for storefront behavior

Shopify wants storefront JavaScript moved into an app embed block delivered through a theme app extension. App embeds appear in the theme editor, can be toggled by the merchant and work with both vintage and Online Store 2.0 themes. Because activation is per theme, developers need to confirm the embed is active on the currently published theme and revisit that state when a merchant changes themes.

## Analytics-only scripts should move to web pixels

Shopify recommends web pixels for scripts whose purpose is analytics or conversion measurement. Keeping instrumentation separate from visible storefront behavior can reduce the amount of arbitrary JavaScript injected through the theme path and align tracking with Shopify’s supported pixel sandbox and event model.

## Admin-created custom apps have a harder migration path

Shopify says apps created directly in the admin cannot use app extensions, including theme app extensions and web pixels. Those integrations have no equivalent extension-based replacement for ScriptTags and may need code moved into the theme or a rebuilt distributable app. That makes inventorying app distribution type part of the migration rather than assuming one replacement works everywhere.

## Key details

- Shopify announced the storefront ScriptTag deprecation in August 2026.
- From October 1, 2026, `scriptTagCreate` and `scriptTagUpdate` fail on every GraphQL Admin API version.
- REST Admin API POST/PUT operations for ScriptTags also fail after October 1.
- Older API versions do not preserve ScriptTag write access.
- Existing storefront ScriptTags continue running until March 1, 2027 and remain readable/deletable during the transition.
- On March 1, 2027, Shopify stops injecting ScriptTags into storefront pages.
- Storefront functionality should migrate to app embed blocks in theme app extensions.
- Analytics/conversion collection should migrate to web pixels where appropriate.
- App embed activation is per theme and must be active on the published theme.
- Admin-created custom apps cannot use app extensions and may need a different migration path.

## Builder takeaways

- Inventory every app-owned ScriptTag now and classify it as storefront functionality, analytics, or an obsolete path before choosing a replacement.
- Ship the new app embed or web pixel before October 1 if new installs still need the feature; after the cutoff you cannot create a ScriptTag as a temporary fallback.
- Build a migration flow that deep-links merchants into the theme editor and verifies the app embed is enabled on the published theme.
- Recheck embed activation when merchants publish or switch themes; app installation alone does not guarantee the replacement runs.
- For analytics scripts, validate web-pixel event parity against backend orders and your existing attribution pipeline before deleting the ScriptTag.
- Identify admin-created custom apps separately because they cannot use theme app extensions or web pixels and may require theme code or a rebuilt app.
- Do not conflate the storefront timeline with the earlier Order status page retirement; stores can have completed checkout migration and still depend on a storefront ScriptTag.

## What to watch

- Whether Shopify adds automated migration or merchant-facing tooling before the October write cutoff.
- How Shopify surfaces ScriptTag-dependent app warnings to merchants after October 1.
- Whether major app vendors report theme-switch activation problems with app embeds.
- Further restrictions on legacy ScriptTag read/delete APIs after the March execution shutdown.
- Migration guidance for admin-created custom apps and third-party services that historically depended on pasted access tokens.

## Uncertainties

- The exact merchant impact depends on whether each ScriptTag still provides active storefront functionality and whether the app has already shipped an alternative.
- Theme app embeds solve the supported app-distribution path but introduce per-theme activation state that legacy ScriptTags did not have.
- Custom admin-created apps do not have a direct extension-based replacement, so their migration can require more invasive theme or app changes.

## Sources

- [Storefront script tags](https://shopify.dev/docs/apps/build/online-store/script-tag-deprecation/storefront) — Shopify · primary/vendor · 2026-08-01T00:00:00+12:00. Primary timeline, API failure behavior, migration steps, app-embed activation requirements and custom-app limitations.
- [Script tag deprecation](https://shopify.dev/docs/apps/build/online-store/script-tag-deprecation) — Shopify · primary/vendor · 2026-08-01T00:00:00+12:00. Primary overview distinguishing the earlier Order status cutoff from the March 2027 storefront shutdown.
- [Recent changes to Shopify’s platform — Script tags are deprecated](https://shopify.dev/changelog?filter=deprecation-announcement) — Shopify · primary/vendor · 2026-08-24T00:00:00+12:00. Official action-required deprecation announcement.
- [The ScriptTag resource (legacy)](https://shopify.dev/docs/apps/build/online-store/script-tag-legacy) — Shopify · primary_documentation. Current legacy-resource documentation and retirement dates.

