The new and improved Bulk Updater lets you make large-scale changes to your subscription base directly from the Subscriptions page. Filter down to the subscriptions you want to update, build your actions, and run the job.
Follow the steps below to get started!
Before You Begin
This feature is accessed from the Subscriptions page filters menu. Make sure you have the filters ready for the audience you want to target.
The following actions are currently available in this flow:
Skip Next Order
Change Next Order Date
Swap Variant
Add Line Item
Remove Line Item
Change Line Item Quantity
Change Line Item Price
Remove Discount Code
Add Discount Code
Change Frequency
Change Status
1. Select Your Subscriptions
There are two ways to select the subscriptions you want to update. Choose the method that works best for you.
Option 1: Use Filters
Navigate to Subscription Data > Subscriptions.
Click Filters to open the filter menu.
Add the necessary filters to narrow down the subscriptions you want to update. The subscriptions list will automatically update to reflect the selected filters.
Confirm the list looks correct before proceeding. The bulk update will run against the entire filtered list of subscriptions.
Once your filters are set, click Bulk Update Filtered Subscriptions in the filters menu. A new tab will open with the Bulk Updater builder.
⚠️ Warning: For speed and optimization, please make sure you have filtered the subscriptions to only include the ones you want impacted in the bulk update.
Option 2: Import a CSV
If you already have a list of subscription IDs you want to target, you can upload a CSV instead of using filters.
Navigate to Subscription Data > Subscriptions.
Click Filters to open the filter menu, then click Import CSV for Bulk Update.
Upload a CSV file where subscriptionID or subscription ID is a column header, with one subscription ID per row.
Click Import. A new tab will open with the Bulk Updater builder pre-loaded with your uploaded subscriptions.
2. Confirm Selected Subscriptions
The Select Subscriptions tab shows the filtered list your job will run against.
If you want to exclude specific subscriptions from the filtered list, uncheck any individual subscriptions you want to exclude from the job.
Once you've finalized the selected set of subscriptions, click Next to be taken to the Actions stage.
3. Build Your Actions
There are currently eight actions available in this Bulk Updater. To get started:
Select your first Action from the dropdown. See below for the available actions and their inputs.
Fill in the required fields for your selected action.
Click Add Action to add additional actions to the same job (up to 10 total).
Once you've chosen your action(s), click Next to confirm the job.
📌 Note:
All actions are applied to subscriptions in their originally filtered state.
For multi-action bulk updates, actions run sequentially.
Variant-targeting actions, such as Remove Line Item, Change Line Item Quantity, and Swap Variant, will only run on subscriptions that contained the targeted variant in their originally filtered state and still contain it at the time the action runs. If both conditions are not met, the subscription will be skipped from the action.
Skip Next Order
This action skips the next scheduled order for each subscription in your filtered set.
No additional input is required for this action beyond selecting the action type.
Change Next Order Date
This action updates the next order date of all subscriptions in your filtered set.
Select how you want to change the next order date. You can set dates in two ways:
Static date: Set a single specific date that all targeted subscriptions will be updated to.
Relative date: Shift the next order date by a number of days, weeks, or months from the current next order date.
For static next order date change, pick a calendar date.
For relative next order date change, set the Delay Value and Delay Unit.
Swap Variant
This action replaces a specific product variant with a different variant across all subscriptions in your filtered set that contain the original variant.
Select the Swap From variant—the product variant you want to replace—using the product selector.
If you are swapping from a variant you've deleted in Shopify, you can manually enter the Shopify Variant ID of the deleted variant.
Select the Swap To variant—the product variant you want to swap it to—using the product selector.
Select the Price Source for the swapped variant:
Inherit line item price: The swapped variant keeps the same price as the original line item.
Custom price: Set a new specific price for the swapped variant.
Select the line item type you want this action to target—All Lines, One-Time Only, Recurring Only.
(Optional) Check Update Quantity to also update the quantity of the swapped variant. If enabled, select a quantity type:
Static Quantity: Set a specific quantity for the "swap to" variant.
Quantity Multiplier: Multiply the current quantity by a specified value.
📌 Note:
Swap Variant only applies to subscriptions that contained the selected From variant in their originally filtered state and still contain it at the time the action runs, including bundle child lines. Subscriptions that don't meet both conditions will be skipped.
Bundle parent products cannot be used as the From or To variant. Only bundle child line items can be targeted by this action.
If you are swapping from a variant you've deleted in Shopify, you can manually enter the variant ID.
Swapping is not enabled by default on prepaid subscriptions. If you need to swap variants on prepaid subscriptions, contact your CSM.
Add Line Item
This action adds a specific line item (product variant) to each subscription in your filtered set.
Select the product variant you want to add using the product selector.
Set the price and quantity you'd like the line to be added at.
Select the line item type you want to add the product variant as—One-Time or Recurring Only.
📌 Note: Prepaid subscriptions will be skipped.
Remove Line Item
This action removes a specific line item (product variant) from each subscription in your filtered set that contains the line item.
Select the product variant you want to remove using the product selector.
If you are removing a variant you've deleted in Shopify, you can manually enter the Shopify Variant ID of the deleted variant in the product selector.
Select the line item type you want this action to target—All Lines, One-Time Only, Recurring Only.
📌 Note:
The action only applies to subscriptions that contained the selected product in their originally filtered state and still contain it at the time the action runs. Subscriptions that don't meet both conditions will be skipped.
Bundle line items and prepaid subscriptions will be skipped.
If the targeted line item is the only remaining recurring line item on the subscription, the action won't be taken. You will need to separately update those subscriptions to be cancelled or swapped to a different product.
Change Line Item Quantity
This action updates the quantity of a specific line item (product variant) in all targeted subscriptions that contain the product variant.
Select the product using the product selector.
Select the line item type you want this action to target—All Lines, One-Time Only, Recurring Only.
Select your quantity type. You can set quantity in two different ways:
Static Quantity: Set a specific quantity for the selected product variant.
Quantity Multiplier: Multiply the current quantity of the selected product variant by a specified value (e.g., multiply by 2 to double quantities across the board).
Set the quantity value, depending on the quantity type selected.
📌 Note:
Change Line Item Quantity only applies to subscriptions that contained the selected product in their originally filtered state and still contain it at the time the action runs. Subscriptions that don't meet both conditions will be skipped.
Bundle line items and prepaid subscriptions will be skipped.
Change Line Item Price
This action updates the price of a specific line item (product variant) in all targeted subscriptions that contain the product variant.
Select the product using the product selector.
Select the line item type you want this action to target—All Lines, One-Time Only, Recurring Only.
Input the desired price.
📌 Note:
Change Line Item Price only applies to subscriptions that contained the selected product in their originally filtered state and still contain it at the time the action runs, including bundle lines (both parent and child). Subscriptions that don't meet both conditions will be skipped.
Prepaid subscriptions will be skipped.
Remove Discount Code
This action removes a specific Shopify discount code from all subscriptions in your filtered set that have it applied.
Enter the Shopify Discount Code you want to remove.
Add Discount Code
This action applies a Shopify discount code to all subscriptions in your filtered set.
Enter the Shopify Discount Code you want to apply.
📌 Note:
The discount code must already exist in your Shopify store before running this action.
If you've enabled the code combination settings on the discount codes in Shopify, codes will stack on subscriptions that already have one applied.
Change Frequency
This action updates the billing frequency for each subscription in your filtered set.
Enter a Frequency Value (numeric).
Select the Frequency Unit—Day(s), Week(s), or Month(s).
📌 Note: Prepaid subscriptions will be skipped.
Change Status
Updates the subscription status for each subscription in your filtered set.
Select the new Status you want to apply—Active, Paused, Cancelled, or Expired.
📌 Note:
If changing status to Paused, you must also select a Pause Until date. This is the date the subscription will resume and the next order will generate.
Expiring subscriptions will disallow customers from reactivating their subscriptions.
Expiring prepaid subscriptions will only expire after all remaining orders have been processed.
4. Download the Pre-Update CSV
Before you can run the job, you are required to download a CSV report of the subscriptions in their current state.
In the Confirmation step, click Download CSV.
Find the CSV in your downloads folder. It serves as a backup record of the subscription data before any changes are made.
Once the CSV has been downloaded, the Run Update button will become active.
💡 Tip: If you need to compare pre- and post-update data, you can find both CSVs available for download on the Bulk Updater History page after the job completes.
5. Run the Job
Click Run Update to start the job.
A progress view will display, showing the job status and percentage complete. You can also view the status on the Bulk Updater History page (see step 7).
⚠️ Queuing multiple jobs before one has completed can produce unintended changes. When jobs are queued back-to-back, each subsequent job applies changes to subscriptions that may have already been updated by the previous one. If your jobs target the same subscriptions, the results may not reflect what you intended. To avoid this, wait until a job shows a completed status before creating a new one.
Job statuses you may see:
Queued — The job is waiting to be processed.
Running — The job is actively being applied to subscriptions.
Paused — The job has been manually paused.
Complete — All actions have been applied successfully.
Failed — The job has failed and no changes have been made.
⚠️ Only one bulk update job per store runs at a time. Queued jobs will start running only when all other jobs' statuses are either Completed, Cancelled, or Failed.
6. Manage a Job in Progress
While a job is running or queued, you have three options to manage it:
Pause — Temporarily stops the job. It can be resumed.
Resume — Restarts a paused job where it left off.
Cancel — Stops the job permanently. Actions already applied will not be undone.
These controls are available directly in the progress view. You can also access them from the Bulk Updater History page (see below).
⚠️ Warning: Cancelling a job does not reverse actions that have already been applied. If you need to revert changes, use the Pre-Update CSV as your reference.
7. Review Results in Bulk Updater History
All jobs run through the new Bulk Updater are logged on the Bulk Updater History page. To access it:
Navigate to Subscription Data > Bulk Updater History in the left-hand menu.
From this page you can:
View the status and details of all past and present Bulk Updater jobs run through the Subscriptions page
📌 Note: The Bulk Updater History page logs only jobs created through the new Bulk Updater flow. Jobs from the legacy Bulk Update Tool are tracked separately on the legacy Bulk Updater history page.
Pause, Resume, or Cancel an in-progress job
Download the Pre-Update CSV — the snapshot taken before the job ran
Download the Post-Update CSV — a record of the subscription data after the job completed
💡 Tip: Comparing the two CSVs lets you verify exactly what changed and identify any subscriptions that may need follow-up.