> For the complete documentation index, see [llms.txt](https://help.smartrr.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartrr.com/docs/support/bulk-updates/how-to-manage-subscription-price-updates.md).

# How to Manage Subscription Price Updates

The Bulk Updates tool allows you to update the prices for products in multiple subscriptions at once. Follow the steps below to complete the process from start to finish.

When you update a product's price in Shopify, your **existing subscriptions keep their original (grandfathered) price** — they don't update automatically. This help doc walks you through how Smartrr detects those price changes and how you can review and apply them to your affected subscriptions, all from the **Bulk Updates** page.

{% hint style="info" %}
This only affects subscription line item pricing. Selling plans, discounts, and billing schedules are never modified.
{% endhint %}

#### Step 1: Get notified of a price change

Smartrr automatically detects when a product's price changes in Shopify. No setup is required — this works in the background.

1. Once a change is detected, you'll see a notification in your Admin Portal.
2. Go to **Subscriptions > Bulk Updates**.
3. Click the **Price Changes** tab.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FQKmBN1XT4XbzDqkExH1b%2Fimage.png?alt=media&amp;token=0246eede-0af1-4935-a40e-d4b53dea4339" alt="Screenshot: the Bulk Updates page with the Price Changes tab selected, showing detected price changes as cards"><figcaption></figcaption></figure>

{% hint style="info" %}
Only true price changes trigger this flow — updates to other product details (like inventory count) won't show up here.
{% endhint %}

#### Step 2: Review affected products

Each price change appears as its own card, showing:

* The product name
* The old price → the new price
* The number of active and paused subscriptions affected
* The date the change was detected

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FkvzAWnV2hGqNFfj5vP95%2Fimage.png?alt=media&amp;token=2f838aeb-fc15-475e-9c36-5da33f40ebf4" alt="Screenshot: a close-up of a single Price Changes card, e.g. &#x22;Organic Matcha Powder — 100g, $24.99 → $27.99, 9 active subscriptions affected&#x22;"><figcaption></figcaption></figure>

#### Step 3: Decide how to handle the change

For each product, choose one of two options:

<table><thead><tr><th width="103.1328125">Option</th><th>What happens</th></tr></thead><tbody><tr><td><mark style="color:green;"><strong>Update</strong></mark></td><td>All active and paused subscriptions for this product are updated to the new price.</td></tr><tr><td><strong>Ignore</strong></td><td>Affected subscriptions keep their current (grandfathered) price. The card is dismissed from this page.</td></tr></tbody></table>

{% hint style="info" %}
You don't need to act right away. If you dismiss a notification without choosing, it will still be available anytime under the **Price Changes** tab so you can come back to it later.
{% endhint %}

#### Step 4: Confirm the bulk update

If you choose **Update subscriptions**, you'll see a confirmation step before anything changes.

1. Review the number of subscriptions that will be affected.
2. Confirm that only the line item base price will change — selling plans, discounts, and billing schedules are untouched.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FXiXs4vybECg8pqeAMM45%2Fimage.png?alt=media&amp;token=8b80e0cc-593f-43dd-b091-c033c3593926" alt="Screenshot: the &#x22;Confirm bulk price update&#x22; dialog, including the legal best-practice notice"><figcaption></figcaption></figure>

{% hint style="info" %}
**Legal best practice:** Many jurisdictions require advance notice before raising recurring subscription prices. Consider notifying your customers in the next step.
{% endhint %}

3. Click **Confirm & continue**.

#### Step 5: Choose whether to notify customers

After confirming, you'll be asked whether to let affected subscribers know about the price change.

<table><thead><tr><th width="210.8828125">Option</th><th>What happens</th></tr></thead><tbody><tr><td><strong>Yes, notify customers</strong></td><td>Smartrr automatically emails every affected subscriber once the update finishes.</td></tr><tr><td><strong>No, skip notification</strong></td><td>No email is sent. Customers will see the new price reflected on their next billing cycle.</td></tr></tbody></table>

If you choose to notify customers, you can preview the email before sending:

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2FI6EpixumTeQuxL4PaJXh%2Fimage.png?alt=media&amp;token=236ca749-0a56-45b8-9a01-7bd8c47e533a" alt="Screenshot: the &#x22;Notify customers?&#x22; dialog with the email preview shown below the toggle"><figcaption></figcaption></figure>

{% hint style="info" %}
This notification template can't be customized yet. It automatically includes the affected product, old and new price, when the new price takes effect, and a link for the customer to manage their subscription.
{% endhint %}

4. Click **Update & send notification** (or **Update** if you skipped notifications).

#### Step 6: Confirm the update completed

* You'll initially see a message to confirm that the update has been scheduled and is processing.
* Smartrr will then email the user who initiated the bulk update(s) a summary once the update completes, rather than making you wait on the page.

<figure><img src="https://3658670565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FndNAuxS4koYyI8AQTpS9%2Fuploads%2Fqac0GzNnzoXBohLmQj8v%2Fimage.png?alt=media&amp;token=2749cc37-2aae-467d-8645-849d3db18c7b" alt="Screenshot: the &#x22;Prices updated successfully&#x22; confirmation, e.g. &#x22;14 subscriptions were updated to the new prices. Notification emails have been sent to all affected subscribers.&#x22;"><figcaption></figcaption></figure>

The merchant summary email includes:

* How many subscriptions were updated successfully
* Any subscriptions that failed to update
* An attached CSV results file. This contains details on all subscriptions and line items updated. Information included:
  * Line Item ID
  * Variant ID
  * Subscription ID
  * Customer's email
  * Subscription update status
  * Customer was notification status (email sent: Y/N)

{% hint style="info" %}
If any subscriptions or notifications fail, reach out to Smartrr Customer Support — our team can review the failed records with you and advise on next steps.
{% endhint %}

***

### What customers see

If you choose to notify customers, affected subscribers receive an email letting them know:

* Which product(s) in their subscription changed price
* The old price and the new price
* That the new price applies starting with their next scheduled charge
* A link to manage their subscription (skip, swap, or cancel) if they'd like

***

### FAQ

**Will this affect new subscribers?** No — new subscriptions are always created using your product's current Shopify price. This flow only affects your *existing* subscriptions that were grandfathered at an older price.

**What if I update the same product's price twice in a row?** Smartrr keeps a single, up-to-date record per product on the Price Changes page, reflecting the most recent unacknowledged price change.

**Can I customize the customer notification email?** Not yet. The current version of the notification template can't be edited.

**What if I don't have any active subscriptions affected by a price change?** You won't be notified — there's nothing to update in that case.

**Can I undo a bulk price update?** If a bulk update fails partway through, the affected job can be safely re-run. If you have concerns about an update that already completed successfully, contact Smartrr Customer Support.

***

*Related articles:*

* [*Bulk Updates*](/docs/support/bulk-updates.md)
* [*How to Bulk Update the Next Order Date for Subscriptions*](/docs/support/bulk-updates/how-to-bulk-update-the-next-order-date-for-subscriptions.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.smartrr.com/docs/support/bulk-updates/how-to-manage-subscription-price-updates.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.