Introduction
Shoppers sometimes pick the wrong option at checkout: a medium jacket instead of a large, or blue instead of black. With the Modify order support skill, your AI assistant fixes this in the chat. It swaps the item on the order for another variant of the same product, updates the order in Shopify, and confirms the change with the shopper. Your team doesn't have to do anything.
You decide how long after purchase changes are allowed and how much the AI may refund automatically. When a change falls outside your rules, the AI explains why and offers to connect the shopper with your team.
The Modify order skill works in the Rep AI chat widget on your store and in Instagram, Facebook Messenger and WhatsApp messages.
What the AI Can Change
The AI swaps one item on an order for a different variant of the same product. For example, a jacket in size M becomes the same jacket in size L.
The AI makes the change only when all of these are true:
- The item has not shipped yet. On an order where some items have shipped, the items that haven't shipped can still be changed.
- The order is inside the time window you set.
- The new variant is in stock.
- The new variant costs the same as, or less than, what the shopper paid.
- The order has no discount applied.
The AI does not:
- Add items to an order or remove items from it
- Change more than one item in a single request
- Swap an item for a different product
- Change quantities
- Collect payment in the chat. If the new variant costs more, the AI hands the request to your team.
- Change shipping costs or the shipping method
How Price Differences Are Handled
Price is always compared to what the shopper actually paid for the item, not to today's price. So if the shopper bought the item on sale, a variant that now sells at full price counts as costing more.
- Same price: the AI makes the change. Nothing is charged or refunded.
- Costs less: the AI makes the change and refunds the difference to the shopper's original payment method, up to the refund cap you set.
- Costs more, or the difference is over your cap: the AI makes no change and offers to hand the request to your team.
If the order hasn't been paid yet (for example, cash on delivery), the AI makes the change and the shopper simply pays the new, lower total. No refund is issued.
Before You Start
The Modify order skill works with Shopify stores. It needs the Order Editing permission in Shopify. If your store doesn't have it yet, Rep AI asks you to approve it the first time you open the skill. Approving it takes one click in Shopify and doesn't affect your other skills or your product catalog.
Setting Up the Modify Order Support Skill
- In your Rep AI dashboard, go to AI Support > Support Skills.
- Find the Modify order card and click Activate.
- If you see Additional permissions required, click Approve Permissions. Shopify opens and asks you to allow Rep AI to edit orders. Approve it. You'll come straight back to the Modify order settings.
- Choose your settings (see below).
- Click Save.
Configuration Options
Standard Policy
Limit item changes by time
When this is checked, the AI only changes items for a set number of hours after the order was placed. The default is 24 hours. Enter a whole number of hours.
- If the time limitation has expired, reply with: the message shoppers see when the window has passed. Default: "Sorry, it's no longer possible to change an item on this order."
If you uncheck this option, there is no time limit. The AI can still change only items that haven't shipped.
Refund automatically up to
The largest price difference the AI may refund on its own, in your store's currency (for example, 25 or 25.50). Use a period for decimals.
- Leave it empty and the AI issues no automatic refunds. Same-price swaps still go ahead, and cheaper swaps go to your team.
If a change isn't possible, reply with:
The message shoppers see when the AI can't make a change. If you leave it empty, the AI uses a clear default message for each situation.
The AI only offers variants that are in stock. If the one the shopper asks for is unavailable, it offers the in-stock options instead.
Custom Policy
Select Custom policy to describe the process in your own words. The AI follows your instructions for how to talk to shoppers. The default custom policy text allows changes for up to 24 hours after the order was placed and automatic refunds up to 100 per order (in your store's currency), and selecting it sets those same limits.
Good to know: editing the hours or the refund amount inside your written policy does not change the limits the AI enforces. If you need a different time window or refund cap, use Standard policy.
How It Works for Your Shoppers
- The shopper asks. For example: "I ordered the wrong size, can I change it?" The shopper doesn't need to name the option. "I picked the wrong one" works too.
- The AI finds the order. It asks for the order number and the email used at checkout, unless it already has them. If the shopper can't find their order number, the AI helps them locate it. Order details are shown only when the email matches the order.
- The AI confirms the item. It names the item and its current variant so you're both talking about the same thing.
- The shopper picks a new variant. The AI lists the variants the shopper can switch to, with their prices.
- In the chat widget, they also appear as cards with a picture, name and price. The shopper taps Select on the one they want, or types it.
- On Instagram, Facebook Messenger and WhatsApp, the options come as a list in the message. The shopper replies with the one they want.
- The AI asks for a final yes. It restates the order number, the current variant, the new variant and the price outcome ("no price difference" or "a refund of 5.00 to your original payment method"). Nothing changes until the shopper says yes. If the shopper picks a different variant, the AI asks again for that one.
- The order is updated. The AI confirms the change in the chat, including any refund. Shopify sends the shopper its usual updated-order email.
If the shopper says no, the order stays exactly as it was.
What You'll See on the Order
After a change, the order in Shopify shows:
- The new variant in place of the old one
- The old variant returned to your inventory
- A note on the order, for example: "Rep AI: swapped 'M' for 'L' (Classic Jacket) at the shopper's request. Refunded 5.00 USD to the original payment method."
- A refund for the price difference, when there was one
If a line has more than one unit (for example, 2 × the same jacket), the AI changes one unit per request and the rest stay as they are.
When the AI Hands Off to Your Team
The AI doesn't make the change, and offers to connect the shopper with your team, when:
- The item has already shipped. The AI also offers to help with a return or exchange once the item arrives.
- The time window you set has passed
- The new variant costs more than what the shopper paid
- The refund would be larger than your cap, or no cap is set
- The order has a discount applied
- The order is part of a subscription
- The item has personalization or custom details attached, like engraving
- The shopper asks to change more than one item, add or remove items, or switch to a different product
- The product is no longer for sale in your store
- No other variant is in stock
When the shopper accepts the handoff, your team receives the order number, the item, the variant the shopper wanted, any price difference and the reason the AI stopped. Your team can finish the change without asking the shopper again.
Important Notes
- Changes happen in Shopify only. If you use a third-party warehouse or fulfillment service, it may not pick up the change automatically. Set a time window that ends before your orders are sent for fulfillment.
- Taxes: the automatic refund covers the price difference before tax. If your prices don't include tax, Shopify may show a small remaining amount due to the shopper for the tax difference. You can refund it from the order in Shopify.
- Shipping costs are not recalculated.
- No payment is ever collected in the chat.
Troubleshooting
I see "Additional permissions required" when I open Modify order
Your Shopify connection doesn't include the Order Editing permission yet. Click Approve Permissions and approve the request in Shopify.
The AI hands off cheaper swaps instead of making them
Check that Refund automatically up to has an amount. When it's empty, the AI doesn't refund automatically. Also check whether the price difference is larger than your cap.
The AI says a change isn't possible on an order that hasn't shipped
Check the time window. The order may be older than the hours you set. The order may also have a discount, be a subscription order, or include a personalized item. These always go to your team.
A variant the shopper wants isn't offered
The AI only offers variants that are in stock and cost the same as, or less than, what the shopper paid (within your refund cap).
The AI doesn't recognize the shopper's order
Make sure the shopper uses the email from checkout. The AI can only change orders that belong to the shopper it's talking to.
Related Support Skills
- Cancel Order: lets shoppers cancel an order
- Change Order Address: lets shoppers update the shipping address before an order ships
- Returns / Exchanges: handles items that have already been delivered
- Locate Order Number: helps shoppers find their order number
Getting Help
If you need help setting up the Modify order skill, contact our support team.