> For the complete documentation index, see [llms.txt](https://subscriptionsuite.gitbook.io/helpdoc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptionsuite.gitbook.io/helpdoc/getting-started/additional-feature/automated-product-swap.md).

# Automated Product Swap

Automated Product Swaps let you automatically move subscribers from one product to another at a specific point in their subscription.

For example:

**Product A → Product B after the first order**

The customer receives the Product A for their first order. After that order ships, SubscriptionSuite automatically changes their subscription to the Product B for future orders.

You can also use swaps for seasonal products, product upgrades, refill programs, or any subscription where the product should change over time.

Go to:

**SubscriptionSuite → Additional Feature → Automated Product Swaps**

### Turn On Automated Product Swaps

Use the **Automated product swaps** toggle at the top of the page to turn the feature on or off.

Turning it off does **not delete your rules**. Your existing rules stay saved, but no automatic swaps will run until you turn the feature back on.

<figure><img src="https://4127174298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2b41HkDs75AWk1ddL9M2%2Fuploads%2F2iBnc5VPVPAdGiaYJi64%2Fimage.png?alt=media&amp;token=f9d62673-8a78-492d-a9b1-66f0ec1117af" alt=""><figcaption></figcaption></figure>

***

## Create a Swap Rule

Click **Create rule** to set up an automatic product change.

### 1. Choose the Products

Give the rule an internal name so you can recognize it later.

Then choose:

**Swap from**\
The product the customer currently receives.

**Swap to**\
The product they should receive after the rule runs.

For example:

**Starter Kit → Refill Pack**

You can also add an optional note explaining why the rule was created.

<figure><img src="https://4127174298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2b41HkDs75AWk1ddL9M2%2Fuploads%2FE3CyejUBQUFQcaEQkooP%2Fimage.png?alt=media&amp;token=ed98a4da-5811-48c1-ab97-cd6891ea5628" alt=""><figcaption></figcaption></figure>

***

## 2. Choose When the Swap Happens

Under **When**, choose what should trigger the product change.

You can choose:

• **After a specific order**\
• **When a subscription starts**\
• **On a specific date**

#### After a Specific Order

Choose the order number after which the product should change.

For example:

**After order 1**

The customer receives the original product for order 1. The new product starts from **order 2**.

The order that triggers the swap is never changed.

#### When a Subscription Starts

The product is changed when the subscription begins.

#### On a Specific Date

Choose a date when eligible subscriptions should move to the new product.

This can be useful for seasonal changes, such as moving subscribers from a summer product to a winter product.

<figure><img src="https://4127174298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2b41HkDs75AWk1ddL9M2%2Fuploads%2F5diFWlRjyKELQBSkdNzk%2Fimage.png?alt=media&amp;token=f0f47e22-8697-4115-bd7b-10b5b3496d6d" alt=""><figcaption></figcaption></figure>

***

## 3. Choose Which Subscribers Are Affected

Choose whether the rule should apply to:

• **New subscribers only**\
• **New and existing subscribers**

If you choose **New subscribers only**, the rule applies to subscriptions created after the rule is activated.

You can use **Preview list** to check which subscribers currently match the rule before activating it.

***

### Add Customer Conditions

You can optionally narrow the rule so that only certain subscribers are affected.

Available conditions include:

• Customer tag\
• Subscription status\
• Subscription age\
• Current price\
• Delivery frequency

For example, you could create a swap that only applies to customers with a particular Shopify tag.

<figure><img src="https://4127174298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2b41HkDs75AWk1ddL9M2%2Fuploads%2FMlSnEG8iKbGyISCKL2tJ%2Fimage.png?alt=media&amp;token=c3185b86-743d-4cc1-b6ff-5fd393e061ef" alt=""><figcaption></figcaption></figure>

***

## 4. Choose the Price After the Swap

Choose what the customer should pay once the new product is added to their subscription.

Available options are:

• **Keep their current price**\
• **Use the new product's price**\
• **Set a custom price**

This gives you control over whether the swap changes what the customer pays.

***

## 5. Choose the Quantity

Choose what happens to the product quantity after the swap.

You can:

• **Keep current quantity**\
• **Set a quantity**

For most simple product swaps, keeping the customer's current quantity will work.

***

## 6. Notify the Customer

Enable **Email the customer when the swap happens** if you want customers to be informed that their next subscription product has changed.

The email lets them know that the new product will be used for their upcoming orders.

<figure><img src="https://4127174298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2b41HkDs75AWk1ddL9M2%2Fuploads%2Fwzu8NfNRobNDHdeU3UOS%2Fimage.png?alt=media&amp;token=1b2790d5-361a-4154-a1d7-bea93834d759" alt=""><figcaption></figcaption></figure>

***

## Save or Activate the Rule

Once the setup looks correct, you can choose:

**Save as draft**\
Save the rule without running it yet.

**Save and activate**\
Turn the rule on immediately.

The **Rule summary** on the right gives you a quick overview of:

• When the swap happens\
• Who it affects\
• Which price will be used\
• Whether the customer will be emailed

***

### Example

Suppose you sell a skincare starter kit followed by monthly refills.

You can create:

**Swap from:** Starter Kit\
**Swap to:** Refill Pack\
**When:** After order 1\
**Who:** New subscribers only\
**Price:** Use the Refill Pack price

The customer receives the Starter Kit as their first order.

Once that order ships, SubscriptionSuite automatically updates the subscription so every future order contains the Refill Pack.

The customer does not need to make the change themselves.

***

### Good to Know

• The order that triggers the swap is **not changed**\
• The new product starts from the following order\
• You can apply rules to new subscribers or existing subscribers too\
• Conditions let you target specific subscribers\
• Rules can be saved as drafts before activation\
• Turning the feature off keeps your rules saved

***

### Need Help?

If you need help setting up an Automated Product Swap or deciding when a swap should happen, contact us through the in app chat.

Our team is happy to help.
