---
title: Every setting on the Replace product page, explained
description: What each Replace product setting does, its default, what your customer sees, how the price limit and refunds work, and what to check when customers cannot replace an item.
canonical: https://tacey.app/docs/replace-a-product/every-setting-on-the-replace-product-page
updated: 2026-11-16T11:12:12.073Z
---
# Every setting on the Replace product page, explained

**In short:** Replace product lets a customer swap an item on their order for a different product from a list you choose. A pricier swap is paid through Shopify's payment page; a cheaper swap is owed back to the customer. This page has 4 settings. **The safe default allows nothing until you choose at least one collection.**

## Before you start

- **Customer editing must be on.** Turn on **Let customers edit their own order** under **Editing Tools**, then **Global settings**. It is off on a new store.
- **The tool must be on.** Open **Editing Tools** and check **Replace product** is turned on.
- **The Tacey block must be placed** in Shopify's checkout editor (Thank you page) and the customer accounts editor (Order status page). Shopify does not let Tacey see whether you did.
- **Order type matters.** The row never shows on orders paid with Shop Pay Installments, created by another app, still waiting for payment, placed before 2019, local delivery, or a B2B order. A swap changes the order's total, so those are refused. Orders in a currency other than your store's are allowed.
- **Money.** Refunds on a cheaper swap follow **Refund customers automatically** in Global settings. It is off by default, so a refund waits for your approval on the order page.

## How to open the settings

Open **Editing Tools**, choose **Replace product**, then **Configure**, change what you need and save.

## What your customer sees

A **Replace product** row on an item. They pick a replacement from the collections you allowed, see the price difference, confirm, and either pay on Shopify's payment page (pricier) or are owed the difference (cheaper).

## Every setting

### Collections a customer may choose from

**Default: none, which allows nothing.** Choose the collections whose products a customer may swap in. With none chosen, customers cannot replace anything. If a chosen collection is later deleted, the page says "One of these collections is no longer in your store, so nothing can be swapped from it. Remove it and choose another." **Recommended:** one collection per type of swap you want (sizes, colours, a "swap-ins" collection).

### Only if it is in stock

**Default: on.** Refuse the replacement when the product they want is not available. On: a variant that tracks stock and is not allowed to oversell is offered only while enough is available for the quantity being replaced. Off: that stock count is not checked, so a variant with some stock but not enough can still be chosen. A variant Shopify marks as unavailable for sale is refused whichever way this is set, and when you restrict **Locations a replacement may ship from** the stock check at those locations is strict whatever this says. **Recommended: on.**

### Most a replacement's price can differ, per item

**Default: 0, which means no limit.** Any other amount, from 1 to 100000, is the most the price can differ per item, higher or lower.
- A customer who picks something **pricier** pays the difference through Shopify's own payment link, and the order is held until they pay.
- A customer who picks something **cheaper** is owed the difference. It waits on the order page for you to approve, or is refunded automatically if you turned on **Refund customers automatically** in Global settings.

**Recommended:** set a limit that matches your widest real swap, so a customer cannot trade a cheap item for your most expensive one. See [What happens when a customer replaces an item with a cheaper or more expensive product?](/docs/replace-a-product/replace-a-product-price-difference).

### Locations a replacement may ship from

**Default: none, which lets Shopify choose.** Only offer replacements stocked at these locations. See [How do stock, locations and quantity limits work when customers add a product?](/docs/add-a-product/add-a-product-stock-and-locations).

## How the settings work together

- **Collections decide what is offered; stock and locations decide what is allowed.** A product in an allowed collection can still be refused for stock or location.
- **The price limit and Refund customers automatically are the money pair.** The limit bounds the amount; the Global switch decides whether a refund goes out by itself.
- **Not the same as Change product options.** Replace changes the product; Change product options changes size, colour or quantity. See [Replace, change options or add a product: which is which?](/docs/replace-a-product/replace-vs-change-options-vs-add-product).

## If it does not work

**The Replace product row is missing.**
1. Check the Tacey block is placed.
2. Check **Let customers edit their own order** is on in Global settings.
3. Check **Replace product** is on in **Editing Tools**.
4. Check the order type and the edit window.
5. If everything has shipped, the customer sees "Everything on this order has already shipped, so it cannot be changed here."

**The row is there but no products appear.** No collection is chosen, a chosen collection was deleted, the products are Draft or Archived, or they are not sold in the customer's market.

**The customer's pick was refused.** Out of stock, outside the price limit, or at a location that is not allowed.

**The money looks wrong.** A pricier swap that is unpaid holds the order and tags it `tacey-payment-owed`. A cheaper swap with no refund yet is waiting for you to click **Approve refund**, or for **Refund customers automatically**.

More: [Why can't my customer replace an item on their Shopify order?](/docs/replace-a-product/replace-a-product-not-working).

## What this does not do

- It does not swap to a product outside your chosen collections.
- It does not refund by itself unless you turned on **Refund customers automatically**.
- It does not charge a saved card.

## Learn more

- [How do I let customers replace a product on their Shopify order?](/docs/replace-a-product/let-customers-replace-a-product)

## Still stuck?

Contact Tacey support from the chat bubble inside the Tacey app, or email hello@taceysupport.app.
