Adding or swapping a product or variant
You may need to add a new product, swap to a different product, or swap variantss on a prepaid subscription for a customer. You can easily add or swap products or variants in the customer account in Recharge. This guide provides an overview of how to change the products in a subscription.
Before you start
- Variant swapping and SKU swapping are terms that are used interchangeably and represent the same action.
- When swapping a product manually or in bulk, consider the following for stores using Bundles:
- Swaps will only work for the parent bundle product. To swap bundle contents, use the bundles swap tool.
- Swapping to customizable bundles does not automatically carry over bundle contents. The contents will be empty until either the customer logs in and makes selections or you manually make selections within the merchant portal. It’s recommended to set fallback contents so these orders won’t be empty if selections aren’t made.
- To understand all available bulk update opportunities, refer to our course Updating subscriptions at scale.
-
You cannot add or swap a product that is configured with dynamic pricing.
- Consider adding additional plans that are not utilizing dynamic pricing to allow for product adding or swapping.
- If adding additional plans that are not utilizing dynamic pricing, be sure to set the product plan settings to not available on the Storefront widget.
Add a product
- Click Customers in the merchant portal and select Customers from the dropdown.
- Search for and select the customer.
- Click Add product.
- Search and click Select on the desired product.
- Click Next and enter the subscription details.
- Click Add product.
Swap a variant
You can swap variants from the merchant portal by updating the variant on an existing subscription.
Customer details page
- Click Customers in the merchant portal and select Customers from the dropdown.
- Search for and select the customer.
- Click the Actions dropdown next to the product and select Edit subscription product.
- Change variant in dropdown. If there is no variant dropdown option, complete a product swap. Changing the product title will not update the product itself.
- Click Save.
Subscriptions tab
- Click Customers in your merchant portal and select Subscriptions from the dropdown.
- Search for the subscription to update variant.
- Click the Actions dropdown and select Edit subscription product.
- Update the variant and select Save. If there is no variant dropdown option, complete a product swap. Changing the product title will not update the product itself.
Swap a product
Rather than removing or cancelling a product and adding a new product, you can use the swap option to switch to a different subscription product.
Customer details page
To swap a product:
- Click Customers in the merchant portal and select Customers from the dropdown.
- Search for and select the customer.
- On the customer details page, click the Actions dropdown and select Swap.
- Choose Swap from the menu.
- Select the product and click Next.
- Change the variant if required. Otherwise click Swap product
Subscriptions tab
- Click Customers in the merchant portal and select Subscriptions from the dropdown.
- Search for and select the customer.
- Search for the subscription to swap.
- Click the Actions dropdown and select Swap.
-
Select a product to swap the subscription to and click Next.
- Choose a variant and select Swap product to confirm. Optionally, you can Edit subscription details and set the quantity, price, shipping interval, and first charge date of the product you're swapping to.
Note the following when swapping products:
- You can enable the ability for customers to swap products within their customer portal settings. This is disabled for your customers by default. You can also update the Edit frequency so that your customers have the ability to choose the date of the next charge when they are swapping products on their own.
- The next charge date of the swapped product is not changed by default. This is to keep the original subscription settings customers checked out with, though the frequency can be edited if needed.
- The expiration settings will carry over if your swappable product is configured to expire after a certain number of charges if you are using Product Subscription Plans.
Swapping variants on a prepaid subscription
If you'd like to swap variants of upcoming shipments during a prepaid subscription cycle, the process is different than a standard product swap.
For more information on changing the variants on prepaid subscriptions, visit Changing the product or variant for an existing prepaid subscription.
Handle a product swap in bulk
There are two methods for updating a product swap in bulk. Review the methods below and select the method based on your needs and preference.
Method 1 - Multi-Select tool
You can use the Multi-select tool to update the product for individual subscriptions on the Subscriptions page. To process the update search and select the subscriptions to be updated on the Subscriptions page and use the Product title, Variant title, and Variant ID in the Edit properties menu on the Actions dropdown.
- The Product title and Variant title are optional. If the titles are remaining the same, you only need to fill in the Variant ID.
- Updating the variant ID does not automatically update other product attributes, such as price or title. If you require other updates, be sure to add these additional properties. To locate IDs, visit find a Shopify variant ID or use find a product ID for BigCommerce.
Review the Multi-select tool guide for detailed instructions.
Method 2 - Bulk Managing Subscription tool
You can use the Bulk Managing Subscriptions tool to make a product swap update. To process this type of update you will need to complete the Importing Subscriptions template with:
subscription_id
product_title
variant_title
-
external_variant_id
- Variant ID is a mandatory column. To locate variant IDs, visit find a Shopify variant ID or see find a product ID for BigCommerce.
The product_title and variant_title are optional columns. If the titles are remaining the same, you only need to fill in the variant_id column. Updating the variant ID will not automatically update other product attributes, such as price or title. If you require other updates, be sure to add these additional columns.
To make an update using the import tool:
- Use the Export Builder to pull the Subscriptions - All or Subscriptions - Active export.
- Copy and paste the required fields noted above from the Subscriptions export into the template file. All other columns in the template can be removed.
- Once your CSV file is ready to import, follow steps 2 and 3 in the Bulk managing subscriptions guide to complete the update.