Bundle content template explained
To migrate your bundles, you must format your exported data into the Recharge bundle content template. The data must be in this format for our system to import it correctly.
This guide provides an overview of the headings within the template and the information required to prepare the file.
- Recharge Checkout on Shopify
- Shopify Checkout Integration
Before you start
- Make sure you’ve completed existing the customer migration (customers, addresses, payment methods, and subscriptions) prior to migrating your bundles.
- Do not change the column titles or headings in the file. Additional columns cannot be added and these existing columns can’t be removed.
- Make sure you do not include any special or strange characters in the data.
- Do not use zero values for cells without any data. Instead, leave the cells blank.
- If you use a filter in your spreadsheet, ensure you haven't inserted blank columns between the default columns we’ve set. If you want to use a filter in your spreadsheet, select all data contained in the file. This way, when you sort the data, it will ensure that you don't mix up the columns.
- After you have added all your data, save your CSV file in UTF-8 format using LF-style linefeeds. If you are not familiar with encodings, then see your spreadsheet or text editor program's documentation.
-
Each unique customer’s bundle contains multiple rows in the spreadsheet, one row for each unique bundle selection. Review the Example bundle migration.
Template headings explained
For mandatory fields, ensure you have entered values in every row of that column.
Column headings |
Description |
|
|
Email of the customer with a bundle subscription. This is required for each row. For example, if a bundle contains 3 different products, the same customer email would be repeated on 3 rows. |
|
|
The Recharge subscription_id of the parent bundle product. It can be found in the Recharge subscriptions export. This is required for each row. For example, if a bundle contains 3 different products, the same subscription_id would be repeated on 3 rows. Note: If you are migrating bundles from an external platform, you can only get this ID after the first migration file is processed. |
|
|
ID of the Shopify collection that includes this bundle content product This must be the same collection configured in the parent product’s Recharge bundle settings. |
|
|
Shopify product ID of each unique bundle content. The Shopify collection(s) configured in the Recharge bundle settings must include this product. Child products must be active on the Online Store sales channel in Shopify. |
|
|
Shopify variant ID of each unique bundle content. The Shopify collection(s) configured in the Recharge bundle settings must include this product. Child products must be active on the Online Store sales channel in Shopify. |
|
|
Number of units of this product included in the customer’s bundle. The sum of the quantities for each unique bundle must match the quantity set in the bundle settings. |
Example bundle migration
In this example, two bundles will be migrated to Recharge.
-
In the first bundle, 3 bundle contents (3 separate products) are added to the parent bundle subscription
-
In the second bundle, 4 bundle contents (2 separate products) are added to the parent bundle subscription
The following table shows an example CSV file for migrating the 2 bundles:
|
|
subscription_id |
collection_id |
external_product_id |
external _variant_id |
quantity |
|
385651958 |
281156681868 |
7150669070476 |
41003670667404 |
1 |
|
|
385651958 |
281156681868 |
7150669463692 |
41003671519372 |
1 |
|
|
385651958 |
281156681868 |
7150668415116 |
41003666407564 |
1 |
|
|
383512534 |
281156681868 |
7150669070476 |
41003670667404 |
2 |
|
|
383512534 |
281156681868 |
7150668415116 |
41003666407564 |
2 |
