Migrating from Shopify Scripts to Shopify Functions
If you're using Shopify Scripts it's time to start planning for the transition to Shopify Functions. Shopify Functions provide a more efficient and scalable solution, offering better performance and flexibility for your customisations.
Why Migrate?
Shopify Scripts and the Script Editor app are currently available only for stores on the Shopify Plus plan. However, the Script Editor app will be discontinued on August 28, 2025. After that date, Shopify Scripts will no longer function. It’s crucial to migrate your existing scripts to Shopify Functions before this deadline.
What Are Shopify Functions?
Shopify Functions are a powerful tool that allows developers to customise the checkout experience. Unlike Shopify Scripts, which require code to be copied into each store, Shopify Functions are installed as part of an app and configured directly within your Shopify admin. This means you don’t need to write code to manage your customisations.
Shopify Functions are built on the WebAssembly platform, which delivers faster performance (executing code in under 5 milliseconds) compared to Shopify Scripts. This makes them ideal for handling high-volume sales events like flash sales without sacrificing performance.
Benefits of Shopify Functions:
-
Improved performance: Code runs faster, reducing processing times.
-
No more manual coding: Customisations can be made without coding, directly in Shopify admin.
-
Better scalability: Shopify Functions support larger events and higher traffic.
-
Fewer limitations: Reduced timeout and CPU memory limit issues.
How to Migrate to Shopify Functions
1. Review Your Current Customisations
To help you migrate smoothly, Shopify provides a personalised Scripts Customisations Report in your Shopify admin. This report lists all your current Shopify Scripts and suggests how to recreate them using Shopify Functions. The report is automatically generated, and you can export it as a CSV file for easy reference.
The report is organised into sections such as:
-
Payment gateways
-
Shipping
-
Product discounts
Each section includes details about your existing customisations, links to related Shopify Functions documentation, and suggestions for apps built with Shopify Functions.
2. Choose Your Path Forward
You can recreate your customisations by:
-
Building your own solution: Using Shopify Functions tutorials.
-
Using compatible apps: Install apps built on Shopify Functions that match your customisation needs.
Note:
Shopify Functions-based apps require the use of Shopify App Bridge. If you're creating custom apps, you’ll need to use the Partner Dashboard to build and connect the app to your store.
3. Recreate Your Customisations
To begin migrating your scripts, follow these steps:
-
In your Shopify admin, go to Settings > Apps and sales channels.
-
Click Script Editor.
-
In the Replace your Shopify Scripts banner, click Replace Shopify Scripts.
-
For each section in your Customisations report, do the following:
-
Click the name of the script to view existing customisations.
-
Install any compatible apps from the Recommended apps section.
-
Click on How to recreate using Shopify Functions for links to relevant tutorials.
Once you've successfully tested an app or Shopify Functions customisation, deactivate the corresponding Shopify Script.
Working with Both Shopify Scripts and Shopify Functions
Until August 28, 2025, Shopify Scripts will continue to work on customised checkouts. During this transition period, you can use Shopify Scripts and Shopify Functions together. If you can't yet replace a script with a Shopify Function, continue using Shopify Scripts until the APIs support your needs.
Key Interactions Between Shopify Scripts and Shopify Functions:
-
Line item scripts: These run before Shopify Functions and can't access discounts created by functions or apps.
-
Shipping scripts: These execute after Shopify Functions-based delivery customisations and can’t modify renamed delivery options.
-
Payment scripts: These run after payment customisations made with Shopify Functions and cannot affect renamed payment options.
Conclusion
Migrating from Shopify Scripts to Shopify Functions is essential before the August 2025 deadline. Shopify Functions offer improved performance, flexibility, and scalability, making them the future of customising your Shopify store. Use the Shopify Scripts customisations report to begin the migration process, and take advantage of Shopify Functions and compatible apps to recreate your customisations seamlessly. Review the Shopify functions roadmap for more information on when switches are targeted to take place.
