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 before June 30, 2026:

  1. Review your existing customizations in the Shopify Scripts customizations report.
  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 existing Scripts customizations that are active in your store, 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. You need to recreate your customizations using Shopify Functions before June 30, 2026.

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 your existing Shopify Scripts customizations.

  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 your existing Shopify Scripts customizations, 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.

Using Shopify Scripts and Shopify Functions at the same time

Shopify Scripts and Shopify Functions can be used at the same time in a single store. If your scripts can't currently be replaced by using Shopify Functions, then continue to use Shopify Scripts until the Shopify Functions APIs meet your needs. Shopify Scripts will continue to work on checkouts that are customized with checkout.liquid and on checkouts that have been upgraded until June 30, 2026.

Refer to the following table to determine how Shopify Scripts and Shopify Functions interact:

Table listing the types of Shopify Scripts and the limitations with how they interact with Shopify Functions.
Shopify Script typeInteractions between Scripts and Functions
Line item scripts
  • Line item scripts execute before Shopify Functions, including discounts created by apps.
  • Line item scripts can't access amounts that are discounted by functions and apps.
  • Scripts can access only the first discount code that's applied to the checkout, and they can't access other discount codes that might have been used. For example, using reject operates on the first discount applied to the checkout, and doesn't affect other discounts.
Shipping scripts
  • Shipping scripts execute after delivery customizations that are created with Shopify Functions.
  • Scripts can't operate on modified delivery customization rename results, but can operate on customizations that move or hide delivery methods.
Payment scripts
  • Payment scripts execute after payment customizations that are created with Shopify Functions.
  • Scripts can't operate on modified payment customization rename results, but can operate on customizations that move or hide payment methods.

Resources about Shopify Functions

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