> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/subscriptions/managing-subscriptions/changing-shipping-on-a-subscription-contract.md).

# Changing shipping on a subscription contract

Move an existing subscription contract to a different shipping rate, or set a custom rate, so renewals keep billing as your shipping setup evolves.

A contract's shipping rate is assigned when the contract is created. It doesn't have to stay that way: click **Edit shipping rate** on the contract to move it onto a different rate. Changes apply to all future orders.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FzYReJfSyJtdp9LVOJ40f%2FScreenshot%202026-09-09%20at%2012.09.11%E2%80%AFPM.png?alt=media&#x26;token=3271e8de-4361-40e3-9168-e2cf5a1e8991" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Looking to waive shipping as a perk instead? See [Rewarding a subscriber with free shipping](/subscriptions/managing-subscriptions/rewarding-a-subscriber-with-free-shipping.md).
{% endhint %}

### Pick a new rate

The **Shipping rate** dropdown offers every shipping option available to the customer, as configured in your Shopify shipping profiles for the contract's shipping address, each shown with its price. Pick one and click **Update**.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FeC9e2gN3s6dXHinHVp5N%2FScreenshot%202026-09-08%20at%209.41.31%E2%80%AFPM.png?alt=media&#x26;token=6974e31a-9138-4c2d-93e2-79837aef1bed" alt="" width="375"><figcaption></figcaption></figure>

If none of your configured rates fit, choose **Enter rate manually** to create a custom rate for this contract: give it a **Shipping rate name** and a **Shipping price** in your store currency.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FmTnod7oTwoyiYO26w2Ja%2FScreenshot%202026-09-08%20at%209.45.45%E2%80%AFPM.png?alt=media&#x26;token=1ecea387-c1b5-4876-9293-c548773a395d" alt="" width="375"><figcaption></figcaption></figure>

### When you'll want this

* **Your shipping offer changed.** For example, the contract was created while you offered free shipping, and you've since retired that rate. Move the contract onto one of your current rates instead of being stuck with the old one.
* **The contract's rate was deleted from Shopify.** This happens when a market closes or shipping profiles get restructured. A contract still pointing at a deleted rate can't bill its upcoming orders, so reassigning it to a current rate gets renewals flowing again, without recreating the contract.

{% hint style="info" %}
Restructuring your shipping zones or Shopify Markets? Check which contracts reference the rates you're removing and move them to a current rate first, before their next billing date.
{% endhint %}

### The change is logged

Every rate change writes to the contract's Timeline with the old and new rate, their prices, and who made the change. See [The Subscription Activity Timeline](/subscriptions/managing-subscriptions/the-subscription-activity-timeline.md).

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FX0Eo1Vbyg2U0LaAovNzP%2FScreenshot%202026-09-09%20at%201.20.24%E2%80%AFPM.png?alt=media&amp;token=fd8d7987-97ce-411b-96fe-750f3a05478e" alt="" width="325"><figcaption></figcaption></figure>

#### Related guides

* [Rewarding a subscriber with free shipping](/subscriptions/managing-subscriptions/rewarding-a-subscriber-with-free-shipping.md)
* [Adjusting an upcoming subscription order](/subscriptions/managing-subscriptions/adjusting-an-upcoming-subscription-order.md)
* [Updating a customer's payment method](/subscriptions/managing-subscriptions/updating-a-customers-payment-method.md)
* [Shipping discounts for subscription orders](/subscriptions/getting-started/shipping-discounts-for-subscription-orders.md): storefront shipping discounts for subscription checkouts and renewals


---

# 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://docs.roadmap.so/subscriptions/managing-subscriptions/changing-shipping-on-a-subscription-contract.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.