Bulk Updater in Recurly Commerce

Bulk Updater lets you update multiple active subscription contracts at the same time, without editing each contract individually.

Bulk Updater currently supports two update types:

Only one update type can be configured per bulk update.

Before you begin

Product Swap requirements

Before running a Product Swap, make sure the replacement product is ready:

1. Create the replacement product in Shopify.
2. Set the new product to Active.
3. Confirm the new product is associated with the correct plan in Commerce.
4. Draft or unlist the old product in Shopify if you no longer want it available for new subscriptions.
5. If swapping from a product without variants to one with variants, create the required variant mapping in Shopify before running the swap.

Drafting or unlisting the old product does not change existing subscriptions. It only prevents new subscribers from selecting that product.

Price Update behavior

A Price Update changes the contract’s base recurring price. Existing discounts remain in place and continue to apply to the new price.

For example, if a subscriber has a 10% discount and their base price is updated to $25, the 10% discount still applies to the new $25 price.

Create a bulk update

Step 1: Open Bulk Updater

1. In Commerce, go to Bulk Updater.
2. Click Create Bulk Update.

Step 2: Choose the update type

Select either Price Update or Product Swap.

Step 3: Configure the update

The available fields depend on the update type selected.

• Price Update: Select the product variants to update, then enter the new price.
• Product Swap: Select the current source variant, then select the target variant subscribers should be moved to.

Step 4: Review impacted contracts and subscribers

Before running the update, review the affected records. You can download:

• Contracts CSV
• Subscribers CSV

The Bulk Update Summary shows the selected update type, selected variants, impacted contracts, and impacted subscribers.

Preview the update

Recurly recommends previewing every bulk update before applying it to live contracts.

1. Click Preview Bulk Update.
2. Confirm the preview.
3. Review the completed preview in the Bulk Update History table.

After the preview completes, open the preview details to review the results. To apply the same configuration to live contracts, click Apply Update.

Run the update

To apply the update to live contracts, click Run Bulk Update.

If you have not run a preview, you will see a warning before continuing. You can either run a test first or continue without testing.

Once confirmed, the update begins processing. You will receive an email when processing is complete.

Monitor results

Bulk Update History

Preview and production runs appear in the Bulk Update History table. Use this table to review the status and results of each run.

Activity logs

Each updated subscription contract receives an activity log entry. The actor is shown as Bulk Updater.

• Price Update entries show the product name and updated price.
• Product Swap entries are recorded at the contract level.

Contracts Impacted

The Contracts Impacted view shows affected contracts, including plan name and date updated.

Limitations

• Bulk Updater currently supports USD only.
• Contracts using non-USD currencies are not eligible for bulk updates.
• Bulk updates cannot be easily undone after they are applied.
• Contracts CSV and Subscribers CSV downloads are available before and after a run.

Frequently asked questions

How long does a bulk update take?

Processing time depends on the number of contracts included in the update. As a general guideline, expect about one hour per 1,000 contracts.

What should I do if my preview has errors?

Most preview errors are related to discounts. You may need to update the affected discounts in Shopify or remove discounts from contracts where they should no longer apply.

Can a bulk update be reversed?

Bulk updates are not easily reversible. If you need help reverting a completed update, contact Recurly Support with the bulk update details and the desired contract state. Reversal requests may take up to 5 business days.

Can I update the total contract price without keeping the existing discount?

No. Bulk Updater preserves existing discount logic. To change a contract price without keeping the existing discount behavior, use the contract-level Change Price option instead.

If you have any questions or concerns regarding Bulk Updater, please reach out to Recurly Support!