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

## ScriptTag change highlights

**Starting February 1, 2025, apps will no 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. Existing ScriptTags will continue to work until August 28, 2025 for Plus shops and until a later date to be announced for non-Plus.**

ScriptTags on the Order Status page have been deprecated and will be turned off on August 28, 2025, for Plus merchants and for all other merchants at a later date yet to be announced. 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 will not impact merchants who already have your app today. However, when the Plus upgrade deadline passes in August and the non-Plus deadline passes at a later date to be announced, 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>

The non-Plus deadline will be announced with a minimum of a one year notice period.

## 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 [customizations report](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?

If you believe your app no longer requires a `display_scope` of `order_status` or `all`, you can submit the following form and we will update your ScriptTag `display_scope` to `online_store` for existing merchants.

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 does not implement any customizations on the Order Status page to avoid impacting your app’s functionality for both new and existing merchants. Any functionality that relies on ScriptTags on the Order Status page will break.

Submit the form by January 27, 2025 and we will make the scope change by February 1, 2025.

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