Articles on: Setup & Onboarding

📝 Quick Start Guide — First Edit, First Upsell

Experience how Account Editor works from your customer’s perspective.



⭐ Why This Matters


Before configuring advanced rules, this guide helps you see the real customer workflow end-to-end.


You’ll complete:


  • Your first order edit
  • Your first address change
  • Your first shipping recalculation
  • Your first order cancellation
  • Your first upsell activation


This “hands-on test” ensures your store is fully ready before going live.



1. What Customers See After Checkout


Account Editor appears automatically on:


✔ Thank You Page (right after checkout)

Editing Block On Thank You Page



Customers will see:


  • Edit Order button
  • Add Item / Remove Item
  • Change Address
  • Change Shipping Method
  • Cancel Order button
  • Upsell offers (if enabled)


✔ Order Status Page (Redirect From Thank You Page)


This is where MOST edits happen, because customers open it from the email.

Customer workflow:


Order Status Page


  1. Click Edit Order
  2. Widget opens with editable options
  3. Customer makes changes
  4. Shopify recalculates totals
  5. Customer confirms
  6. You receive timeline updates + optional email notifications


✅ 2. Your First Item Edit (Variants, Quantity, Add/Remove)



How to test it:


  1. Place a test order
  2. On the Thank You Page → click Edit Order→Redirects To Order Status Page
  3. Try all four allowed actions:


✔ Change variant


Example: M → L

Checks variant mapping + inventory logic.


✔ Change quantity


Validates line-item recalculation.


✔ Remove an item


Tests refund/price decrease scenarios.


✔ Add an item



Tests product picker and upsell compatibility.


Behind the scenes:


  • AE modifies the order
  • Shopify recalculates tax + shipping
  • Final price updates before confirmation
  • Nothing is committed until customer clicks Confirm


3. Your First Address Edit


How to test:



  1. Click Edit Address in the widget
  2. Modify street, apartment, or postal code
  3. Confirm address

What to expect:


  • Google Address Suggestions 
  • Shopify validation rules (e.g., postal format)
  • Address rules based on your Markets configuration


AE will block address editing when:


  • Order is fulfilled
  • Address is invalid
  • Store does not ship to that country
  • Editing Window Time Is Over


4. Your First Shipping Recalculation


Any of the following will trigger shipping recalculation:



  • Changing item quantity
  • Changing variants (weight changes)
  • Removing/adding items
  • Changing shipping address


Shopify recalculates rates, NOT Account Editor


This includes:


  • Carrier-calculated rates
  • Market-based rates
  • Rule-based shipping profiles
  • Free-shipping thresholds

If shipping becomes $0 / ₹0


Common causes:


  • No matching rate in your shipping profile
  • Any Discount Condition Is Applied Which Is Active On Store
  • A discount code that includes free shipping
  • An automatic discount that unlocks free shipping after edits
  • A spend threshold (“Free shipping above $50”)
  • Market-based free shipping rules for certain countries
  • Customer tag–based free shipping
  • Market rules conflict

(This is explained later in the Shipping Editing article.)


5. Your First Cancellation



Let customers test the cancellation flow:

How to test:


  1. Open the test order
  2. Click Cancel Order
  3. See restocking fee (if enabled)
  4. Order is canceled automatically


Cancellation is blocked when:


  • Order is already fulfilled
  • Order is partially fulfilled
  • You disabled this option in settings


6. Your First Upsell (Instant Activation)


Enable the upsell engine:



  1. Open Account Editor
  2. Go to Upsell Engine
  3. Turn it ON
  4. Create a simple offer (e.g., “Add Socks for $5”)
  5. Save

Now test:


  1. Place a new test order
  2. Go to Thank You Page
  3. Upsell should appear instantly

What to check:


  • Product image & price
  • Discount (if applied)
  • Conversion event (when customer accepts)


Best practice:

Use a low-cost product as your first upsell — they convert best.


7. Recommended Default Settings for New Stores


Turn ON these to get the best early results:


  • Allow item editing
  • Allow address editing
  • Enable cancellations before fulfillment
  • Enable default upsell block
  • Set edit window to 10–30 minutes
These are the highest-impact, low-risk settings.


8. Go-Live Checklist


Your store is fully ready when:


🔲 App Embed is enabled

🔲 Account Editor block is added (TYP + OSP)

🔲 You placed a test order

🔲 Item editing works

🔲 Address editing works

🔲 Shipping recalculates correctly

🔲 Cancellation flow works

🔲 Upsell appears and functions

🔲 Timeline notes appear in Admin

🔲 Notification emails work correctly


🧪 Real Merchant Scenarios


Scenario A — “Customer can't see the Edit button”


Likely cause: App Embed disabled

Fix: Online Store → Customize → App Embeds → enable AE


Scenario B — Editing works on TYP but not on Order Status Page


Cause: Block added only to TYP

Fix: Add block to OSP too


Scenario C — Shipping prices look wrong


Cause: Shopify shipping profiles returning unexpected rate

Fix: Check your shipping rules; weight or zone may have changed


Scenario D — Upsell not appearing


Cause:


  • No offer configured
  • Product unavailable
  • Product restricted

Fix: Review Upsell Engine setup


⚙️ Best Practices (Recommended for All Stores)


  • Use simple products for first upsell
  • Keep edit window short (10–20 min)
  • Avoid allowing edits after fulfillment
  • Enable restocking fee to prevent abuse
  • Encourage customers via email to “Review or Edit Order”


❓ FAQs


Q: Do customers need an account?

A: No — guest checkout fully supported.


Q: Can I disable some edit options?

A: Yes. You can limit item edits, address edits, cancellations, and shipping edits.


Q: Does this affect checkout?

A: No. Checkout is untouched. AE only shows on post-purchase pages.


Q: Does this work with subscriptions?

A: Some subscription apps restrict edits. See “Editing Eligibility” article.


⚠️ Common Errors & How to Fix Them


Issue

Cause

Fix

 Edit button missing 

 App Embed off 

 Enable under App Embeds 

 Upsell not showing 

 No offer configured / product unavailable 

 Create or update offer 

 Shipping is wrong 

 Shopify recalculation returned no matching rate 

 Check shipping profiles 

 Order edit fails 

 Item restricted or fulfillment lock 

 Adjust eligibility rules 


🔗 Related Guides



Updated on: 17/12/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!