⚠️ Action Required by 14 May 2026
If your store is on the older version of our Shopify Customer Account extension portal, you must switch to the new split-block setup before 14 May 2026.
After that date:
The older extension will be permanently retired.
Your customer portal will stop loading for subscribers.
🔍 Why We're Doing This
Shopify enforces a hard 64 KB size cap on every customer-account UI extension.
Our original portal was a single block — but as we kept adding features such as:
Skip
Swap
Edit
Bundle support
Order history
Quick actions
...and more
…we ran out of room within Shopify's size limit.
Our Solution
To stay within the cap and keep shipping new features, we split the portal into multiple smaller extension blocks, each scoped to a single feature.
The Upside for You and Your Subscribers
✅ The customer portal loads noticeably faster, because each block only ships the code it actually uses.
📦 What Changed
The single "Subscription management" block has been replaced by a set of focused "Customer Portal" blocks.
⚠️ All of them are required. They work together to give subscribers a complete portal, and missing any one will leave parts of the portal non-functional.
The Full Block List
Block | What It Does |
Subscription Management | The entry page — lists all of a customer's subscriptions. |
Subscription Detail | The detail view for a single subscription (line items, schedule, address, payment). |
Subscription Quick Action | Inline actions (skip, pause, reschedule) directly from the list. |
Edit Subscription | Add / remove / swap products on a subscription. |
Upcoming and Past Order details | Preview the next scheduled order(s) and past order details. |
Subscription Bundle | Build-a-Box / bundle support inside the portal. |
Subscription Product Update | Product update flows (variant changes, etc.). |
🛠️ How to Migrate
Follow these 5 steps in order to complete your migration.
Step 1: Open Your Customer-Account Theme Editor
You can do it directly from Shopify Admin
Go to Online store → Edit theme → Customer accounts → Customize.
Step 2: Add All of the Following Blocks (All Required)
Add all 8 blocks to your customer-account page:
✅ Subscription Management
✅ Subscription Detail
✅ Subscription Quick Action
✅ Edit Subscription
✅ Upcoming and Past Order Details
✅ Subscription Bundle
✅ Subscription Product Update
Step 3: About the "Add to Menu" Prompt ⭐
When you add each block, Shopify will ask whether to add it to the customer account menu.
Block | Add to Menu? | Reason |
Subscription Management | ✅ YES | This is the entry point your subscribers click into. |
Subscription Detail | ❌ Don't add to menu | Reached via deep-link from inside the list. |
Subscription Quick Action | ❌ Don't add to menu | Reached via deep-link from inside the list. |
Edit Subscription | ❌ Don't add to menu | Reached via deep-link from inside the list. |
Upcoming and Past Order Details | ❌ Don't add to menu | Reached via deep-link from inside the list. |
Subscription Bundle | ❌ Don't add to menu | Reached via deep-link from inside the list. |
Subscription Product Update | ❌ Don't add to menu | Reached via deep-link from inside the list. |
💡 Why this matters: These blocks are reached via deep-links from inside the list and don't need their own menu entry. Adding them would just clutter the customer's account navigation.
Step 4: Remove the Deprecated Block
If your customer-account page still has the old "Subscription management" block:
Remove it.
It will stop working after 14 May 2026.
Step 5: Click Save
Click Save in the theme editor.
🎉 That's it. The new portal is live for your subscribers as soon as you save.
❌ What Happens If I Don't Migrate
After 14 May 2026, the older Subscription management block will be permanently removed.
Impact Summary
Area | Status After 14 May 2026 |
Old "Subscription management" block | 🚫 Permanently removed |
Customer portal page | ⚠️ Subscribers will see a broken / empty page until you add the new "CP -" blocks |
Subscriptions themselves | ✅ Not affected |
Billing | ✅ Continues to work |
Contracts | ✅ Continues to work |
Webhooks | ✅ Continues to work |
Customer self-management | 🚫 Customers won't be able to self-manage their subscriptions until the new blocks are installed |
Please watch the Loom to follow the instructions.
💬 Need Help?
Our team can walk you through the migration end-to-end.
📧 Email: support@appstle.com
💬 Live Chat: Message us through the chat widget in the Appstle Subscriptions admin app.
🕐 Our experts are available 24×7×365.