Setting Up Account Editor on Legacy Customer Accounts
Purpose
This guide explains how to correctly set up Account Editor on legacy Shopify customer accounts, where only one app block/widget is supported.
If your store is using legacy customer accounts, the setup flow is slightly different from newer Shopify customer account experiences. Following this guide ensures order editing, cancellations, and upsells work correctly.
β Why This Matters
Legacy customer accounts have important technical limitations:
- Only one Account Editor block can be added
- The block must be added to a specific template
Missing or incorrect placement causes:
- βApp installed but nothing showsβ
- Editing links not appearing
- Cancellation flows failing
Correct setup:
- Enables customer self-service
- Prevents cancellations due to simple mistakes
- Reduces support tickets and fulfillment errors
π§ How Legacy Setup Works (High-Level)
Legacy setup happens in three required stages:
- Enable editing capabilities (quick toggles)
- Add the Account Editor block to the correct theme template
- Configure cancellation behavior
All three must be completed for Account Editor to function.
πͺ Step-by-Step Setup (Legacy Accounts)
β Step 1: Enable Editing Capabilities
After installing Account Editor, youβll see a guided setup screen.
Here you choose what customers are allowed to edit:
- Edit shipping address
- Edit order items
- Add items (upsells)
- Recalculate shipping or discounts (if enabled)
These toggles define what actions appear inside the widget later.

Click Continue to proceed to the dashboard.
β Step 2: Add the Account Editor Block (Most Important Step)
This is the critical difference for legacy accounts.
From the Account Editor dashboard:
- Click Configure Now
- Shopify opens the Theme Editor
- Log in if prompted
- From the top dropdown, select Customer Order
- Open the Template section
- Click Add block
- Select Apps β Account Editor
- Click Save

β οΈ Important Legacy Limitation
Legacy accounts support only one Account Editor block
Adding the block to:
- Thank You page (NOT WORK)
- Order Status page (NOT WORK)
β Step 3: Configure Cancellation Settings
Return to the Account Editor dashboard.
Complete the final setup step:
- Enable Smart Cancellation (optional)
- Configure cancellation reasons
- Add retention offers if applicable
- Save settings
This ensures cancellations, retention flows, and refunds behave correctly.
π§ͺ What Customers Experience (Legacy Flow)
Once setup is complete:
- Customer logs in to their account
- Opens an order
- Sees the Account Editor widget
Can:
- Fix address mistakes
- Edit items
- Add products (if enabled)
- Cancel with retention logic applied
All actions update the existing Shopify order β no new checkout is created.
β οΈ Common Legacy Issues & Fixes
Issue | Cause | Fix |
|---|---|---|
Widget not visible | Block not added | Add block to Customer Order template |
Editing options missing | Toggles disabled | Enable options in Step 1 |
Cancellation not working | Setup incomplete | Finish Step 3 |
Customer sees order but canβt edit | Edit window expired | Check General Settings |
β FAQs
Q: Can I add the block to multiple places?
No. Legacy accounts support only one block, and it must be on the Customer Order template.
Q: Does this affect Shopify emails?
No. Email behavior is controlled separately via Email Notification settings.
Q: Can I use upsells on legacy accounts?
Yes β but only through the single Account Editor widget.
Q: How do I know if Iβm on legacy accounts?
If setup requires adding a block to Customer Order (not Checkout/Thank You extensions), youβre on legacy.
π§ Best Practices for Legacy Stores
- Keep editing rules simple
- Avoid overlapping flows or apps modifying orders
- Pair with Shopify Flow only if necessary
- Test with a real customer account before going live
π Related Guides
β General Settings β Edit Window & Limits
β Email Notifications Settings
Updated on: 25/12/2025
Thank you!
