---
title: Order status script tags
description: >-
  Script tags on the Order status page are sunset. Learn the key dates, what
  your app can still do, and how to replace the functionality.
source_url:
  html: >-
    https://shopify.dev/docs/apps/build/online-store/script-tag-deprecation/order-status
  md: >-
    https://shopify.dev/docs/apps/build/online-store/script-tag-deprecation/order-status.md
---

# Order status script tags

Shopify has already removed script tags from the [Order status page](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page) for most stores, and will remove them from the rest on August 26, 2026. If your app customized that page with a script tag, then it needs a customer account UI extension or a web pixel instead.

This deprecation runs ahead of the one for [storefront script tags](https://shopify.dev/docs/apps/build/online-store/script-tag-deprecation/storefront), and it only covers script tags with a [`display_scope`](https://shopify.dev/docs/api/admin-graphql/latest/enums/ScriptTagDisplayScope) of `order_status` or `all`.

***

## Timeline

| Date | What happens |
| - | - |
| February 1, 2025 | Apps can't create script tags with a `display_scope` of `order_status` or `all`. |
| August 28, 2025 | Script tags stop running on the Order status page for Plus stores. |
| August 26, 2026 | Script tags stop running on the Order status page for all other stores. |

After a store's date passes, any customization that your app made to the Order status page with a script tag stops working for that store.

***

## What to use instead

| If your app uses a script tag to... | Then use |
| - | - |
| Render content on the Order status page | [Customer account UI extensions](https://shopify.dev/docs/api/customer-account-ui-extensions) |
| Track analytics, conversions, or customer behavior | [Web pixels](https://shopify.dev/docs/apps/build/marketing/pixels) |

Web pixels work on any store, but can't render UI. Customer account UI extensions can, but only on upgraded stores, so a visual customization has no replacement until the store upgrades. For a full comparison, refer to [Thank you and Order status pages](https://shopify.dev/docs/apps/build/checkout/thank-you-order-status).

***

## Check whether a store has upgraded

Query the [`CheckoutProfile`](https://shopify.dev/docs/api/admin-graphql/latest/objects/CheckoutProfile) object to find out whether a store has upgraded its Thank you and Order status pages. Use the result to decide which experience your app offers.

***

## Audit your script tags

Read and delete operations still work, so you can find any script tags that your app left behind:

* The [`scriptTags`](https://shopify.dev/docs/api/admin-graphql/latest/queries/scriptTags) query returns your app's script tags, including their `displayScope`.
* The [`scriptTagDelete`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/scriptTagDelete) mutation removes a script tag.

You don't need to delete sunset script tags, because Shopify ignores them on the Order status page. A script tag with a `display_scope` of `all` keeps running on storefronts until March 1, 2027 though, so refer to [Storefront script tags](https://shopify.dev/docs/apps/build/online-store/script-tag-deprecation/storefront).

***

## What app users see

### Banner during install

When an app user installs an app that relies on script tags for the Order status page, Shopify shows a dismissible banner explaining what won't work.

![A banner shown during app install, warning that the app uses script tags on the Order status page](https://shopify.dev/assets/assets/images/apps/online-store/install-banner-scripttags-DmQ-Zu9J.png)

The banner content depends on the store's upgrade state and on whether your app includes customer account UI extensions or web pixels:

| App migration status | Store hasn't upgraded | Store has upgraded |
| - | - | - |
| No UI extensions or web pixels | App user is encouraged to contact you about building them | App user is encouraged to contact you about building them |
| UI extensions only | App user is encouraged to upgrade to access all app functionality | No banner |
| UI extensions and web pixels | App user is encouraged to upgrade to access all app functionality | No banner |
| Web pixels only | No banner | No banner |

### Customizations report

The [checkout upgrade guide](https://help.shopify.com/en/manual/checkout-settings/customize-checkout-configurations/checkout-upgrade-guide#1-review-scripts) summarizes a store's customizations on the Thank you and Order status pages and walks the app user through upgrading.

![The customizations report listing apps that require an update by the app developer](https://shopify.dev/assets/assets/images/apps/online-store/customizations-report-scripttags-CYcJgL8z.png)

If your app uses script tags with a `display_scope` of `order_status` or `all` and doesn't include customer account UI extensions or web pixels, then it appears under **Requires update by app developer** in this report for every store that has your app installed. Some app users uninstall the apps listed there to unblock their own upgrade, so appearing in the report can cost you installs.

***

## Next steps

* [Migrate off storefront script tags](https://shopify.dev/docs/apps/build/online-store/script-tag-deprecation/storefront) before the storefront dates in 2026 and 2027.
* [Build customer account UI extensions](https://shopify.dev/docs/api/customer-account-ui-extensions) to customize the Order status page.
* [Build a web pixel](https://shopify.dev/docs/apps/build/marketing/pixels) to collect analytics and conversion data.

***
