> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payreque.st/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync Product Changes

> Understand what happens to existing subscriptions when you edit a product, and how to selectively sync custom field changes.

# Sync Product Changes

When you edit a product, PayRequest does **not** automatically change any existing subscriptions built from that product. Prices and custom fields are captured on the subscription at the moment it's created — editing the product afterward only affects *new* subscriptions going forward.

<Warning>
  Existing subscriptions are never silently changed by a product edit. If you need to update existing subscribers, use one of the tools below — both require you to explicitly opt in.
</Warning>

## What Gets Captured at Creation

<CardGroup cols={2}>
  <Card title="Price" icon="euro-sign">
    The subscription's `recurring_amount` is set once when the subscription is created and stored independently — it does not reference the product's current price.
  </Card>

  <Card title="Custom Fields" icon="list-check">
    The subscription stores its own copy of the product's custom field configuration at signup time.
  </Card>
</CardGroup>

## Updating Prices on Existing Subscriptions

Product price changes don't propagate to existing subscriptions automatically. To intentionally change the price on subscriptions that already exist, use the **Bulk Price Adjustments** wizard — see [Bulk Price Adjustments](/subscriptions/price-adjustments) for the full guide covering percentage/fixed/set-price increases, scheduling, rounding, and required customer notice periods.

## Syncing Custom Fields to an Existing Subscription

If you add, modify, or remove a custom field on a product, subscriptions created before that change keep their original field configuration. The **Sync with Product** tool on each subscription's detail page lets you review and selectively apply those differences — one subscription at a time.

<Steps>
  <Step title="Open the subscription">
    Go to the subscription's detail page. The **Sync with Product** card shows whether it's **In Sync** or **Out of Sync** with the product's current custom field configuration — this is checked automatically every time you load the page.
  </Step>

  <Step title="Review the differences">
    Click **Sync Fields** (or **Check for Updates** if already in sync) to open the sync modal. Each difference is labeled:

    * **New Field** — exists on the product but not on this subscription
    * **Modified** — the field exists on both but its configuration differs
    * **Removed from Product** — exists on this subscription but no longer on the product
  </Step>

  <Step title="Select which changes to apply">
    Check the boxes for the changes you want to apply. New and modified fields are pre-selected by default; removed fields are not. Applying a "Removed" change deletes the field's current value from this subscription.
  </Step>

  <Step title="Confirm">
    Click to sync the selected fields. Only this subscription is updated.
  </Step>
</Steps>

<Warning>
  Sync changes apply to **that subscription only** — other subscriptions on the same product are not affected. There is no bulk version of this tool; to sync many subscriptions, you'd repeat this per subscription.
</Warning>

## FAQ

<AccordionGroup>
  <Accordion title="If I change a product's price, does it update existing subscriptions?">
    No. The new price only applies to subscriptions created after the change. To update existing subscriptions, use [Bulk Price Adjustments](/subscriptions/price-adjustments).
  </Accordion>

  <Accordion title="If I add a new custom field to a product, do existing subscriptions get it automatically?">
    No. Use the **Sync with Product** tool on each subscription's detail page to add it manually.
  </Accordion>

  <Accordion title="Can I sync custom fields for many subscriptions at once?">
    Not currently — the Sync with Product tool works one subscription at a time from that subscription's detail page.
  </Accordion>

  <Accordion title="What happens to a field's stored value if I sync a removed field?">
    Applying a "Removed from Product" change deletes that field's value from the subscription along with its configuration. The sync modal shows a warning with the current value before you confirm.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Bulk Price Adjustments" icon="calculator" href="/subscriptions/price-adjustments">
    Push price changes to existing subscriptions in bulk
  </Card>

  <Card title="Custom Fields" icon="list-check" href="/products-and-pricing/custom-fields">
    Learn how custom fields work on products
  </Card>

  <Card title="Subscription Lifecycle" icon="arrows-rotate" href="/subscriptions/subscription-lifecycle">
    Understand subscription statuses and billing
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.