Overview
If you are a Shopify Plus merchant still running checkout Scripts, you have a hard deadline staring you down. April 15, 2026 marks the date when editing and publishing Scripts is no longer possible, and on June 30, 2026, all Shopify Scripts will cease to execute entirely. Shopify will not migrate anything for you: every Script in your store needs to be manually reviewed, replaced, and tested. The good news is Shopify built a tool to make the audit painless. The AI-powered Scripts Customization Report helps you recreate your Shopify Scripts customizations with Shopify Functions by either building custom apps or installing a compatible app. This guide walks you through accessing, reading, exporting, and acting on every section of that report.
Contents
What is the Scripts Customization Report?
The Shopify Scripts customizations report is a personalized page in your Shopify admin that displays the existing Scripts customizations active in your store, and provides Shopify Functions documentation or relevant app links that can help you recreate the customizations. Shopify announced it in February 2025 specifically to accelerate the migration away from the legacy Script Editor.
Shopify Scripts customizations reports are generated automatically. You do not need to request one or install anything extra. Depending on the scripts you have installed, your 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. Think of it as your personal migration roadmap, generated from the actual code running in your store.
Before you start
You will need the following before diving in:
A Shopify Plus store with active Scripts. The report section only appears if your store has active Scripts.
Admin access with permission to manage apps and the Script Editor.
A spreadsheet tool (Google Sheets, Excel) if you plan to export and share the CSV with your team or agency.
Tip - Do not rely solely on the automated report. For each active Script, document the business rule it enforces, the trigger conditions, and the expected output. A simple spreadsheet with columns for "Script name," "Business rule," "Keep or drop," and "Replacement path" will keep your team aligned.
Step 1 - Open the report in your Shopify admin
The report lives inside the Script Editor app. Here is how to reach it:
From your Shopify admin, go to Apps > Script Editor.
In the "Replace your Shopify Scripts" banner, click Replace Shopify Scripts.
You will land on the Customizations Report page. You will then see the Customizations Report, broken down by the types of Scripts you use.
What if I don't see the report?
The report section only appears if your store has active Scripts. If you don't see it, your store either has no Scripts running or they've already been removed. Double-check by going to Apps > Script Editor and confirming whether any Scripts are listed. If you previously deleted all your Scripts, the banner will not appear.
Step 2 - Review each section of the report
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. Here is what to look for in each one:
Payment gateways
This section covers Scripts that show, hide, or reorder payment methods at checkout. Payment Scripts show or hide payment gateways, block COD above a certain amount, or surface specific options for tagged customers. The report will list each Script's name, description, and source file so you can review the Ruby logic it runs.
Shipping
Shipping Scripts control which delivery options appear during checkout. Shipping Scripts control which shipping options show up at checkout: hide methods, rename labels, or reorder by priority. The report links to the Delivery Customization Function API tutorials so you can rebuild equivalent logic.
Product discounts
This is typically the largest section. Line Item Scripts modify cart items, including BOGO deals, tiered discounts, automatic bundle pricing, and loyalty rewards. The report highlights recommended apps that handle common discount patterns and links to the Discount Function API documentation for anything custom.
In each section, click the name of the script under the number of auto-detected customizations to review your existing Shopify Scripts customizations.
Step 3 - Export the report as CSV
You can also export your report and view it as a CSV file. This is especially useful if you want to share the inventory with your development team, an agency partner, or stakeholders who do not have Shopify admin access.
On the Customizations Report page, look for the export or download option.
Save the CSV file and open it in your spreadsheet tool of choice.
Add columns for "Keep/Drop," "Replacement method," and "Owner" to turn the export into a working migration tracker.
Tip - Exporting the report as a CSV file makes it easier to review everything in one place. If you manage multiple Shopify Plus stores, export a CSV for each store and consolidate them into one workbook.
Step 4 - Decide which customizations to keep
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.
Go through each Script and ask:
Is this still active in our promotions calendar? Old BOGO campaigns or seasonal shipping rules may no longer be relevant.
Can native Shopify features handle this? Some things Scripts did can now be handled natively. Shopify's automatic discounts, for example, cover many basic BOGO and percentage-off scenarios without any code.
Is this business-critical? Discounts may stop applying, shipping logic could fail, and payment options might behave differently than expected if you miss a Script that matters.
Side note - Avoid rewriting everything at once. Group Scripts by theme, complete one group, test, stabilize, and only then move to the next.
Step 5 - Choose your replacement path
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.
You have three options for each Script:
Option A: Install a Functions-based app from the Shopify App Store
In the Recommended Apps section of the report, click Install for an app that you want to use, or click "More apps like this" to find other compatible apps. This is the fastest path and requires no development work. Install a public app built on Functions, great for common patterns like tiered discounts or shipping rules. No development needed.
Option B: Build a custom Shopify Function
In the "How to recreate using Shopify Functions" section, click the relevant Function API link to access step-by-step tutorials. This path gives you full control over the logic but requires a developer comfortable with JavaScript or Rust.
Shopify Functions-based apps require using the Shopify App Bridge. Custom apps that are created in the Shopify admin don't support the Shopify App Bridge, so custom Functions-based apps must be created by using the Partner Dashboard and then connected to your store. This is an important detail: you cannot build a Functions app from the admin alone.
Option C: Use native Shopify features
Shopify has improved a lot over the years. Many things that once required Scripts can now be done natively. Simple percentage-off discounts, free shipping thresholds, and basic buy-X-get-Y promotions can all be configured in Settings > Discounts without writing a line of code.
Step 6 - Test your replacements and deactivate old Scripts
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. Shopify Scripts and Shopify Functions can be used at the same time in a single store. This parallel-running period is your safety net.
Install or deploy your replacement Function or app.
After deploying your Function, keep your Script active for at least two weeks. Both can run simultaneously. Use this window to compare checkout behaviors across different cart configurations before manually deactivating the Script.
In your Shopify admin, go to Apps > Script Editor and unpublish your existing Script.
Monitor your store's performance and error logs after migration. Have a rollback plan ready if issues arise.
What if my new Function is not triggering?
You might encounter the following issue during migration: Function not triggering - verify the Function is properly enabled and configured. Different behavior - check for differences in input data structure between Scripts and Functions. Also confirm that your app is installed on the correct store and that the Function extension target matches the customization type (payment, delivery, or discount).
Tip - Functions have a hard 5ms execution time limit. Complex JavaScript with large data structures, deep iteration, or regex processing can hit this ceiling. Test with realistic cart sizes, 50+ line items if your store supports bulk orders, before deploying to production.
FAQ
What happens if I miss the June 30, 2026 deadline?
June 30, 2026, is the hard cutoff. After that date, any checkout customization still running on a Script stops working. Discounts won't apply, blocked payment methods become available again, and shipping rules stop firing. Depending on what your Scripts handle, the impact on revenue and customer experience can be immediate.
Can I still edit Scripts before June 30?
April 15, 2026 marks the date when editing and publishing new Shopify Scripts will no longer be possible. After that date, your existing published Scripts continue to run, but you cannot modify them. Plan to have your replacements in place before this edit-lock date so you retain the option to adjust Scripts during parallel testing.
Can Scripts and Functions run 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. Be aware of execution order during this overlap period: execution order has changed. Line Item Scripts ran before Functions, while Shipping and Payment Scripts ran after Functions. If you are running both systems during your transition period, factor this ordering into your testing.
Do I need a developer to migrate?
For simple logic, yes you can migrate without a developer. If your Scripts handle flat discounts, free shipping thresholds, or basic Buy X Get Y offers, Shopify's native discount tools cover the replacement without touching code. Where you'll need a developer is for custom Functions, particularly if your Script reads customer metafields, applies conditional B2B pricing, or enforces rules no App Store app replicates.
Why are Shopify Functions better than Scripts?
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. Functions unlock capabilities Scripts never had. Functions support cart transforms, checkout validation, delivery customizations, payment customizations, and order routing, none of which were possible with Scripts.
How long does a typical migration take?
Migration time depends on how many Scripts you're running and how complex the logic is. A store with one or two simple discount Scripts can typically complete the migration in a few days. Stores running five or more Scripts with custom conditions, tiered pricing, B2B payment rules, or region-based shipping logic should budget two to four weeks.
View on app store