There are upcoming changes, key dates and actions that app developers are required to take related to the use of ScriptTags.

## ScriptTag change highlights

> Deprecated
> Since February 1, 2025, apps are longer be able to create [ScriptTags](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/ScriptTag) on any merchants’ [Thank You or Order Status pages](https://shopify.dev/docs/apps/build/checkout/thank-you-order-status). This is to prevent additional merchants from being blocked or adding work to their future upgrade. ScriptTags created before February 1, 2025, will continue to work until August 28, 2025 for Plus shops and August 26, 2026 for non-Plus shops.

ScriptTags on the Order Status page have been deprecated and will be turned off on August 28, 2025, for Plus merchants and on August 26, 2026, for non-Plus merchants. Aligned to this deadline, Plus merchants are required to upgrade their Thank You and Order Status pages and remove customizations that are achieved using ScriptTags. That functionality should instead be moved to apps using [UI Extensions](https://shopify.dev/docs/api/customer-account-ui-extensions) or [Web Pixels](https://shopify.dev/docs/apps/build/marketing-analytics/pixels).

Apps that have not recreated their ScriptTag functionality using UI extensions and/or Web Pixels are blocking both Plus and non-Plus merchants from upgrading to the new Thank You and Order Status page. Merchants installing these apps are creating extra work for their future upgrades.

## Action required by February 1, 2025:



1. Upgrade your app’s functionality for the Thank You and Order Status pages from ScriptTags to Web Pixels and/or UI Extensions.

2. Update your app and documentation to indicate available functionality for merchants on each Thank You and Order Status pages version.

Encourage merchants to upgrade to the new Thank You and Order Status pages. You can check whether a merchant has upgraded their Thank You and Order Status page using [this API](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/CheckoutProfile).

## Impact of this change on new and existing app installs:

<div class="table-container">
    <table style="width: 100%; table-layout: fixed;">
        <tr>
            <th colspan="3" style="text-align: center; font-weight: bold;">Permitted functionality for <u>new</u> app installs</th>
        </tr>
        <tr>
            <th>App Functionality</th>
            <th>Merchant has not upgraded their Thank You and Order Status page</th>
            <th>Merchant has upgraded their Thank You and Order Status page</th>
        </tr>
        <tr>
            <td>ScriptTags</td>
            <td>x</td>
            <td>x</td>
        </tr>
        <tr>
            <td>Web Pixels</td>
            <td>✓</td>
            <td>✓</td>
        </tr>
        <tr>
            <td>UI Extensions</td>
            <td>x</td>
            <td>✓</td>
        </tr>
    </table>
</div>

This change does not impact merchants who already had your app installed prior to February 1, 2025. However, when the Plus upgrade deadline passes in August and the non-Plus deadline passes on August 26, 2026, ScriptTags will no longer work for these merchants:

<div class="table-container">
    <table style="width: 100%; table-layout: fixed;">
        <tr>
            <th colspan="3" style="text-align: center; font-weight: bold;">Permitted functionality for <u>existing</u> app installs</th>
        </tr>
        <tr>
            <th style="text-align: left;">App Functionality</th>
            <th>Before deadline</th>
            <th>After deadline</th>
        </tr>
        <tr>
            <td>ScriptTags</td>
            <td>✓ (if not upgraded)</td>
            <td>x</td>
        </tr>
        <tr>
            <td>Web Pixels</td>
            <td>✓</td>
            <td>✓</td>
        </tr>
        <tr>
            <td>UI Extensions</td>
            <td>✓ (if upgraded)</td>
            <td>✓</td>
        </tr>
    </table>
</div>

## Merchant-facing communication

To make merchants aware of the limited functionality of your app after February 1, 2025, we will display information when they install new apps. The functionality of your app is already displayed during the upgrade process for the Thank You and Order Status pages.

### Banner during install

The image below shows an example banner that will be displayed during app install.

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/apps/online-store/install-banner-scripttags-59fd700c0ed169271e9e7b27081162e4729a9cc97ea38d9a20adf50d18fba7c6.png" class="lazyload" alt="Install Banner ScriptTags" width="2880" height="1800"></figure>

The content of this banner will depend upon the merchants’ Thank You and Order Status page upgrade state and whether you have implemented functionality in Web Pixels and/or UI Extensions:

<div class="table-container">
    <table style="width: 100%; table-layout: fixed;">
        <tr>
            <th colspan="3" style="text-align: center; font-weight: bold;">Banner content</th>
        </tr>
        <tr>
            <th>App migration status</th>
            <th>Not upgraded</th>
            <th>Upgraded</th>
        </tr>
        <tr>
            <td>Has not implemented UI extensions or web pixels</td>
            <td colspan="2">Merchant will be encouraged to contact the app developer to encourage development of UI extensions and/or web pixels.</td>
        </tr>
        <tr>
            <td>Has implemented UI extensions only</td>
            <td>Merchant will be encouraged to upgrade to access all app functionality</td>
            <td>No banner</td>
        </tr>
        <tr>
            <td>Has implemented both UI extensions and Web Pixels</td>
            <td>Merchant will be encouraged to upgrade to access all app functionality</td>
            <td>No banner</td>
        </tr>
        <tr>
            <td>Has implemented Web Pixels only</td>
            <td colspan="2">No banner: Web pixels work on both versions</td>
        </tr>
    </table>
</div>

> Caution:
> If you do not implement UI extensions and/or Web Pixels by February 1, 2025, we expect the number of new app installs for your app to significantly decrease.

### Customizations report

The [upgrade guide](https://help.shopify.com/en/manual/checkout-settings/customize-checkout-configurations/checkout-upgrade-guide#1-review-scripts) is an AI-powered report that summarizes a merchant’s customizations on the Thank You and Order Status pages. It guides merchants through their upgrade process.

<figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/apps/online-store/customizations-report-scripttags-f002d7e96ea4687f0fc973b235830d44461064626ed48c6e675b4c6a054c2b6a.png" class="lazyload" alt="Customizations Report ScriptTags" width="2880" height="1800"></figure>

If your app uses ScriptTags with a `display_scope` of `order_status` or `all` without Web Pixel and/or UI extension functionality, it will be displayed under the “Requires update by app developer” section of the customizations report for all merchants with the app installed. Learn more about `display_scope` [here](/docs/api/admin-graphql/unstable/enums/ScriptTagDisplayScope).

This report allows merchants to review any deprecated customizations and encourages them to recreate them using UI extensions and/or Pixels on the Thank you and Order status page. When apps have not already upgraded their app to use UI Extensions and/or web pixels, we’ve observed merchants choosing to uninstall apps to unblock their upgrade.

We expect the uninstalls of apps that have not provided functionality through UI extensions and/or Web Pixels to continue to increase as we get closer to the upgrade deadlines for Plus and non-Plus.

## Does your app still require ScriptTags on the Order Status page?

> Tip
> If your app no longer requires a `display_scope` of `order_status` or `all`, then you can [submit this form](https://docs.google.com/forms/d/e/1FAIpQLScSLLaxbkzAqY6xoKI_tvj0N0iwtzEN3-wJpZ5HLKTr2pmPZw/viewform) and we'll update or delete your ScriptTag for existing merchants:

If your app no longer requires a `display_scope` of `order_status` or `all`, then you can submit the following form and we'll update or delete your ScriptTag for existing merchants:

- If your ScriptTag's `display_scope` is `all`, then we'll update it to `online_store`.
- If your ScriptTag's `display_scope` is `order_status`, then we'll delete it.

This will prevent the banner from being shown for new app installs and will remove your app from the customizations report. Please ensure that your app doesn't implement any customizations on the Order Status page to avoid impacting your app’s functionality for both new and existing merchants.

> Caution:
> If you submit the form, then you'll break your app's functionality for merchants who are still using the legacy Order Status pages.

We'll accept form submissions until August 28, 2025. Please allow up to one week after submitting the form for the changes to take effect.

[Go to form](https://docs.google.com/forms/d/e/1FAIpQLScSLLaxbkzAqY6xoKI_tvj0N0iwtzEN3-wJpZ5HLKTr2pmPZw/viewform)