> 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/rewarding-a-subscriber-with-free-shipping.md).

# Rewarding a subscriber with free shipping

Apply a free shipping promotion to an active subscription contract: for a set number of renewals or all future orders, as a reward, a retention offer, or a goodwill gesture.

Free shipping is one of the strongest perks you can hand an existing subscriber, and you can apply it directly to an **active contract**: no coupon, no checkout, no waiting for the next signup. Use **Add free shipping** on the contract and the discount takes effect from the next order.

It's a 100% shipping discount layered on top of the contract. The underlying shipping rate is kept, and the discount can be removed at any time. To reduce the shipping cost permanently, [change the contract's shipping rate](/subscriptions/managing-subscriptions/changing-shipping-on-a-subscription-contract.md) instead.

### Ways to use it

* **A loyalty reward**: give long-running subscribers free shipping on their next few renewals, or make it permanent for your best customers.
* **A retention offer**: a subscriber is wavering, so offer free shipping on their next three orders instead of losing the contract.
* **Service recovery**: something went wrong with an order, and waiving shipping for a cycle or two is a concrete way to make it right.

### Apply it

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FACd3IKleKI04E8vZz2V2%2FScreenshot%202026-09-09%20at%2012.13.09%E2%80%AFPM.png?alt=media&#x26;token=5399db71-eabc-470e-8fca-0cfbe262e365" alt="" width="563"><figcaption></figcaption></figure>

* **Discount title**: the name shown on the contract's Discounts row, *Free Shipping* by default. The customer-facing surfaces use it too, so name it something they'll recognise.
* **Applies to**: choose **All future orders** for a permanent perk, or **Limited number of orders** and set the **Number of orders** for a time-boxed one.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FtuVCbCw5vQUjaI8e9N2c%2FScreenshot%202026-09-08%20at%209.41.43%E2%80%AFPM.png?alt=media&#x26;token=b08bc5b1-b946-4c77-9e6c-18317fa1cfb3" alt="" width="375"><figcaption></figcaption></figure>

### What it looks like on the contract

The contract's **Discounts** row shows the discount with its remaining coverage, for example *1 of 1 cycles remaining*, and a **Remove** action for ending it early. The totals show the shipping cost offset in full.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FtumYJanOwJNDhaTxpZzF%2FScreenshot%202026-09-08%20at%209.42.35%E2%80%AFPM.png?alt=media&#x26;token=df7f1b84-360e-4cbb-8aa2-03491d0c8bb9" alt="" width="563"><figcaption></figcaption></figure>

The contract's Timeline records the promotion with its coverage and who added it, for example *Shipping discount of 100% off applied to the next 4 orders*, so your team can always see why a contract is shipping free.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FFGHE4HjNnk7QxQ9jeNag%2FScreenshot%202026-09-08%20at%209.43.28%E2%80%AFPM.png?alt=media&#x26;token=db949116-581d-4200-a527-2ecaec38f582" alt="" width="328"><figcaption></figcaption></figure>

#### Related guides

* [Changing shipping on a subscription contract](/subscriptions/managing-subscriptions/changing-shipping-on-a-subscription-contract.md)
* [Reward subscribers with loyalty points](/loyalty-and-rewards/points-and-ways-to-earn/reward-subscribers-with-loyalty-points.md)
* [The Subscription Activity Timeline](/subscriptions/managing-subscriptions/the-subscription-activity-timeline.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/rewarding-a-subscriber-with-free-shipping.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.