Help
Log in

Transitioning from Shopify Scripts to Shopify Functions

Shopify Functions, similar to Shopify Scripts, let developers create custom commerce experiences. Shopify Functions offer an improved and robust customization experience to help developers and merchants create and extend the capabilities of their Shopify stores. Functions are more user-friendly and accessible because they're distributed as apps, and Functions don't require users to interact with code.

To transition from Shopify Scripts to Shopify Functions, you need to complete the following steps:

  1. Review the customizations that were active before Shopify Scripts was deprecated.
  2. Recreate your customizations by doing any of the following options:

On this page

Understanding the benefits of Shopify Functions

Shopify Functions are installed as part of an app. They're configured alongside other features directly in your Shopify admin, which means that merchants don't need to use code when they're creating or modifying customizations. The WebAssembly platform that runs Shopify Functions offers better performance than Shopify Scripts, executing code in under 5 milliseconds. Because of this, Shopify Functions can support large sales events, such as flash sales, with no decrease in performance.

By using Shopify Functions, developers can code and unit test in their own local environment. Developers distribute their Shopify Functions customizations as part of an app, rather than copying and pasting code into each store. Finally, timeout and CPU memory limit issues are reduced by using Shopify Functions.

Transitioning to Shopify Functions with the Shopify Scripts customizations report

The Shopify Scripts customizations report is a personalized page in your Shopify admin that displays the Scripts customizations that were active in your store before Shopify Scripts was deprecated on June 30, 2026, and provides Shopify Functions documentation or relevant app links that can help you recreate the customizations.

Shopify Scripts customizations reports are generated automatically. You can also export your report and view it as a CSV file.

Review your customizations

Depending on the scripts that you have installed, your Shopify Scripts customizations report page can contain sections for Payment gateways, Shipping, and Product discounts customizations.

Each section can include the name, description, and source file links of your Shopify Scripts customizations, links to recommended apps that are built with Shopify Functions and that are specific to your customizations, and links to Shopify Functions tutorials.

Review the report's information to decide on the customizations that you want to keep. If there's a customization that you no longer use, then you don't need to recreate it using Shopify Functions and you can ignore it. The customizations that you do want to continue using need to be recreated with Shopify Functions. Some customizations can be recreated by installing an existing app, and some customizations might require you to manually recreate them using an included Shopify Functions API guide.

Steps:

  1. From your Shopify admin, go to Apps > Script Editor.

  2. In the Replace your Shopify Scripts banner, click Replace Shopify Scripts.

  3. In each section that you have in your Customizations report, click the name of the script under the number of Auto detected customizations to review the customizations that were active before Shopify Scripts was deprecated.

  4. Decide which customizations you want to keep using, and then consider your options for recreating them using Shopify Functions.

Recreate your customizations

You can use the Shopify Scripts customizations report to inform how you recreate your scripts-based customizations using Shopify Functions. For the customizations that you want to continue using, you can use any combination of the following methods to recreate them with Shopify Functions:

Steps:

  1. From your Shopify admin, go to Apps > Script Editor.

  2. In the Replace your Shopify Scripts banner, click Replace Shopify Scripts.

  3. In each section that you have in your Customizations report, do any of the following:

    • To view the customizations that were active before Shopify Scripts was deprecated, click the name of the script under the number of Auto detected customizations.
    • To view or install compatible apps that match your scripts, in the Recommended apps section, click Install for an app that you want to use, or click More apps like this to find other compatible apps.
    • To view Shopify Functions tutorials, in the How to recreate using Shopify Functions section, click the relevant Function API link.

When you've successfully tested your customization with an app or a manual Shopify Functions customization, you can deactivate the script that you're replacing.

Resources about Shopify Functions

For more information about transitioning from Shopify Scripts to Shopify Functions, refer to the following resource list: