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.



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



  • 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 




Updated on: 11/05/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!