How to bulk add or remove free gifts using the Import tool
Recharge's Import tool simplifies managing free gifts added through an experience, allowing you to efficiently bulk add or remove them from upcoming subscription charges.
This guide explains how to add and remove free gifts using the Import tool.
- Shopify Checkout Integration
- Migrated Shopify Checkout Integration
Before you start
- Use Rewards to offer incentives such as free gifts or discounts to customers on recurring orders.
Step 1 - Download and format the required CSV file
Download the CSV file and update your customers' information before performing the bulk update:
- Download either:
- The Add free gifts CSV
- The Remove free gifts CSV
- Remove the
Headercolumn from the CSV file. - Use the chart below to format your CSV file:
Header
Description
Required to bulk add a gift
Required to bulk remove a gift
external_variant_id A unique string of numbers identifies the specific variant of a product in a subscription.
This field specifies the variant IDs of the free gifts variant to be added.
✅ ❌ external_variant_ids A unique string of numbers identifies the specific variant of a product in a subscription.
This field specifies the variant IDs of the free gifts variant to be added.
❌
✅
charge_id A unique string of numbers is given to each charge. This field specifies the upcoming charges to which the free gift will be added. ✅ ✅ quantity This is the number of free gifts added. ✅ ❌
- Save your CSV file.
charge_id but different external_variant_id. Each row represents one free gift being added to the order.Step 2 - Import the CSV file
After preparing the CSV file, you must import the file into Recharge using the Import tool.
- In the merchant portal, click Tools & Apps, then select Bulk updates.
- Click Import a CSV update.
- Click on Select your update type, choose Add free gifts or Remove free gifts from the dropdown menu, and click Next.
- Upload your CSV file and click Next: preview update.
- Confirm the details of your update and select Confirm: prepare update.
- On the Bulk update page click Process update and select Update free gifts.
Check the Processing status on the Bulk updates page to confirm that the bulk update is complete.
Considerations
Consider the following when bulk adding or removing the free gifts:
Consideration |
Notes |
| Shopify shipping profiles | Review your Shopify shipping profiles to ensure customers are not charged shipping for free gift rewards. |
| Free gift product updates | When you set a product as a free gift in an experience, Recharge uses the product details available at that specific time. Due to a Shopify limitation, if you update the product or add variants, the product details do not automatically update to include the new variants. To use the updated product as a free gift, you must recreate the experience, activate it, and deactivate the existing one. Recreating the experience ensures the product details are up-to-date and prevents the variant does not exist error. Additionally, you cannot swap the free gift after adding it to an order. Setting your flow limits based on your inventory levels is important to avoid out-of-stock issues. |
| Targeting gift products |
This tool is specifically designed to add or remove gift products only. If a customer’s order includes a regular subscription or one-time purchase product that shares the same variant ID as a gift product, the tool will not modify the regular product. The tool only targets gift items based on the properties defined in your bulk import file. Your standard subscription and OTP products are safe from unintended changes. |
