> For the complete documentation index, see [llms.txt](https://docs.2checkout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.2checkout.com/subscriptions/subscriptions/packaging-and-pricing/set-up-subscription-updates/renewal-with-a-new-product-version.md).

# Renewal with a new product version

## Overview

The feature facilitates your customer to experience faster and easier updates to your products. Renewal with a new product version enables your customer to automatically get an updated version of your product during the subscription renewal process. The feature also enables you to choose which version the shopper updates to, whether it is the latest version or another version which predates the latest one.

## Benefits  <a href="#benefits__00a0" id="benefits__00a0"></a>

* Enabling easier updates for your customers&#x20;
* Enhancing their user experience and assuring customer satisfaction&#x20;

## Availability  <a href="#availability__00a0" id="availability__00a0"></a>

The feature is available to all merchants using subscription services.&#x20;

## Limitations  <a href="#limitations__00a0" id="limitations__00a0"></a>

The feature can be applied to all subscriptions with the limitation that the intermediary upgrade option is only available upon request.&#x20;

## Use Cases  <a href="#use-cases__00a0" id="use-cases__00a0"></a>

### Use Case 1: Renewal with the Latest Product Version

1. You have an online shop selling digital products, amongst these being anti-virus software that is being updated yearly.
2. A customer has the 2022 version of the product.
3. Upon renewal, the new product on the subscription will be the 2023 version of the product, without any additional actions for the shopper.

### Use Case 2: Multi-Step Renewal with an Intermediary Product Version for better customer retention

1. You have an online shop selling your products.
2. You want to offer differentiated product packaging for renewing customers, depending on the current version of their subscription plan. For the customer that initially subscribed to the standard version of your product, you can reward them by automatically updating their plan to a product with more features when they renew the first time.
3. For the same customers, the next time they renew you can reward them by automatically updating their product and their subscription plan with even more features and benefits.

### Use Case 3: Silent upgrade & intermediary silent upgrade in Channel Manager

Channel Manager now supports renewal with a different product version and allows merchants to deprecate old products and transition partners to new versions. If the targeted product at renewal is not in the partner's price list, the subscription should renew with the same product.

The intermediary silent upgrade enables merchants to offer partners different renewal prices depending on the number of renewals. For example, if a merchant sells product A with a 10% new acquisition discount to their partner, after one year, the partner gets a 15% renewal discount; if the partner renews a second time, the renewal discount is 25%.

The silent upgrade can be leveraged by any merchant using Reseller management.

## Renewal with a new product version <a href="#renewal-with-a-new-product-version__00a0" id="renewal-with-a-new-product-version__00a0"></a>

To apply a renewal with a new product version, you must follow the following steps:&#x20;

1. Navigate to *Products*, under *Setup*, and run a search to identify the upgraded product. Click to edit it, and then select the **Upgrade** tab.&#x20;
2. Choose the upgradable products from the list in the **Edit your upgrade options** area. Multiple selections are possible when holding down the CTRL key.&#x20;
3. In the **Renewal with a new product version** section, you can select the following options:&#x20;

* **This is an intermediary version before upgrading to the final product version** if you want to make an intermediary update to a closer version before updating to the latest version&#x20;
* **2Checkout Monthly Subscription is a newer version of other products** if you want to update the customers to the latest version&#x20;

<div data-with-frame="true"><figure><img src="https://3137980357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdTPb2ipDVVSZO7QfRjJ4%2Fuploads%2FKRF3MIKabfvTSiaTSQYH%2Fimage.png?alt=media&amp;token=4565b8f4-f500-4422-8e06-e2f55ea82167" alt=""><figcaption></figcaption></figure></div>

## How it works <a href="#how-it-works__00a0" id="how-it-works__00a0"></a>

After the renewal with a new product version is activated, it is applied in the following way at renewal time:

1. For the intermediary upgrade mode, it will first upgrade from the deprecated version to the next product version in the upgrade schema. At the next renewal, the subscription will be upgraded to the newer/last product version. This is illustrated in the diagram below.​<br>

   <div data-with-frame="true"><figure><img src="https://3137980357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdTPb2ipDVVSZO7QfRjJ4%2Fuploads%2F8aHxoNl0KEd95pcxP4SY%2Fimage.png?alt=media&amp;token=6a02c99f-3d44-4173-a3c4-064247d1cbb7" alt=""><figcaption></figcaption></figure></div>
2. If the intermediary upgrade is not activated, then the deprecated version will be directly updated to the latest version of the product. This is illustrated in the diagram below.​<br>

   <div data-with-frame="true"><figure><img src="https://3137980357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdTPb2ipDVVSZO7QfRjJ4%2Fuploads%2F109YwRBu1MZjyyxWAFEL%2Fimage.png?alt=media&amp;token=588deae1-682b-4da3-a4df-d0a4e1c13b70" alt=""><figcaption></figcaption></figure></div>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.2checkout.com/subscriptions/subscriptions/packaging-and-pricing/set-up-subscription-updates/renewal-with-a-new-product-version.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.