Bulk managing one-time products
Manage one-time products stored in Recharge in bulk on your timeline using Recharge's built-in Import Tool.
This guide provides an overview of the bulk management tools, common bulk management use cases, and resources for processing bulk updates in the merchant portal.
Before you start
- This tool is for updating and maintaining existing one-time products. You cannot create or cancel one-time products using the bulk update tool.
- Store owners have account permissions to use bulk management tools by default. Store owners can grant permissions to other staff members from the accounts page.
- You can perform other bulk updates from the merchant portal, including updating existing subscriptions in bulk. See Bulk Management Tools for more details.
Bulk update one-time products
This update type changes specific one-time product properties. With this bulk update, you can edit the following properties for multiple products at one time:
- External product ID
- External variant ID
- Price
- Product title
- Variant title
- Properties
- Quantity
- SKU (Review Updating SKUs for existing and future subscription orders before bulk updating SKUs)
Update one-time products with the Import tool
Step 1 - Prepare a CSV file
You must prepare your store data in a CSV file using the Recharge upload template to use the import tool. Refer to the chart below for additional information about the content required to perform the update:
COLUMN TITLE |
SUMMARY |
onetime_id |
The numerical ID associated with the one-time product. |
| address_id |
The numerical Address ID associated with a customer’s subscription. If you need to find Address IDs in Recharge:
This column is optional for all bulk update types except discount and address updates. |
| next_charge_scheduled_at | The charge date for the one-time product. |
price |
The cost for the one-time product. This column is required for one-time product price updates. |
| product_title |
The title of the one-time product. This column is required for product title updates. |
properties |
Line item properties are custom forms on a product used to collect additional customization information. Must be styled in JSON format. For example: |
| quantity | The number of one-time products. |
| external_variant_id |
A unique string of numbers is used to identify the specific variant on the subscription. Even if a product has no variants created in your eCommerce platform, it will still have one variant ID assigned. Recharge uses the variant ID to create each charge. This column is required. |
| sku | The SKU associated with the one-time product. |
| variant_title |
The title of the specific variant of the one-time product. This column is optional if you do not use variants. |
Step 2 - Import the CSV file
- In the merchant portal, click Tools & apps and select Bulk updates.
- Select Import a CSV file.
- Select Update one-time products from the dropdown list.
- Import the CSV you prepared in Step 1 to bulk update your one-time products.
- Preview your file updates.
- Select Next: preview update to begin the bulk update.
- Select Confirm: prepare update.
- Click Process update from the Bulk updates page.
- Click Update one-time products.
- Confirm the Processing status from the Bulk updates page once the update is finished.
Revert, delete, or cancel the bulk update
If records cannot be processed or you encounter issues with the update, you can revert the bulk update using a backup file. See Revert, delete, or cancel a bulk update.
