> 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/shopping-carts/convertplus/upgrade-orders.md).

# Upgrade orders

Through upgrade orders, your shoppers can update their subscriptions by changing their product or by selecting a different quantity or pricing option for their existing product.

## Availability

ConvertPlus upgrade orders are available only to 2Checkout merchants that have activated ConvertPlus in their accounts, for subscriptions that were initially purchased through ConvertPlus / Inline cart templates. Contact [2Checkout](https://secure.avangate.com/cpanel/contact.php) for activation.

## How shoppers can access an upgrade link

After the [upgrade options are set up for a product](https://docs.2checkout.com/subscriptions/subscriptions/packaging-and-pricing/set-up-subscription-updates#upgrade-scenarios), shoppers can access the upgrade order links in the following ways:

1. Self service, by using the **Upgrade** button available next to their subscription in ther 2Checkout myAccount shopper support portal.
2. By using an upgrade link available in Control Panel on the subscription page or custom built by you and made available to the shopper (in an email campaign, inside your product, via direct email / chat, etc).

## Upgrade link use cases

{% stepper %}
{% step %}

#### **One upgrade option preselected in the link**

The upgrade option is preselected in the buy link and the shopper lands on the *Upgrade* checkout.

Link example:

{% code overflow="wrap" %}

```
https://secure.2checkout.com/checkout/upgrade?merchant=MERCHANT_CODE&subscription=SUBSCRIPTION_REFERENCE&prod=PRODUCT_CODE
```

{% endcode %}

Landing page: Upgrade checkout

<div data-with-frame="true"><figure><img src="/files/gDIbzhm4OgkKexoA96j4" alt="Upgrade option preselected and included in the Upgrade link"><figcaption><p>Upgrade option preselected and included in the Upgrade checkout</p></figcaption></figure></div>

{% endstep %}

{% step %}

#### **Two or more upgrade options included**

Shoppers will land on the *Upgrade* page, where they will need to choose from one of the displayed option.

Link example:

{% code overflow="wrap" %}

```
https://secure.2checkout.com/checkout/upgrade?merchant=MERCHANT_CODE&subscription=SUBSCRIPTION_REFERENCE&prod=PRODUCT_CODE1%3BPRODUCT_CODE2
```

{% endcode %}

Landing page: Upgrade page

<div data-with-frame="true"><figure><img src="/files/3GjSPGhXsLr5Cxlp6h1h" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### **All upgrade options displayed**

The shopper will land either on the *Upgrade* checkout, if only one upgrade product is set up or on the *Upgrade* page, if more than 1 upgrade option is set up on the product associated with the initial subscriptionn.

Link example:

{% code overflow="wrap" %}

```
https://secure.2checkout.com/checkout/upgrade?merchant=MERCHANT_CODE&subscription=SUBSCRIPTION_REFERENCE
```

{% endcode %}

Landing page: Upgrade page or Upgrade checkout

{% tabs %}
{% tab title="Upgrade page (mobile)" %}

<figure><img src="/files/Aw1JpOBKQgXOj95CXIGy" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Upgrade checkout" %}

<figure><img src="/files/t1vxUeSXf559Om5X7SqP" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}

## Upgrade orders parameters

Here is a list of relevant parameters that might be useful to add in the Upgrade order link, to the base Upgrade URL on ConvertPlus.

Base URL

{% code overflow="wrap" %}

```
https://secure.2checkout.com/checkout/upgrade?
```

{% endcode %}

<table><thead><tr><th width="159">Parameter</th><th width="174.9998779296875">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>merchant</code></td><td>Required</td><td>Your merchant code to identify your account.</td></tr><tr><td><code>subscription</code></td><td>Required</td><td>Identifies the subscription that is being upgraded. Can be lifetime or recurring.</td></tr><tr><td><code>prod</code></td><td>Optional</td><td><p>Adds a product as an upgrade option to the link (needs to be set up as a valida upgrade option for the initial product). </p><p></p><p>Use separator %3B between 2 products e.g.</p><p><code>prod=PRODUCT_CODE1%3BPRODUCT_CODE2</code></p></td></tr><tr><td><code>opt</code></td><td>Optional</td><td>Preselects the specified pricing option group&#x26;option for the selected product. e.g. opt=gr1:val1. Works only with preselected product (1 product per link). <a href="https://docs.2checkout.com/shopping-carts/convertplus/convertplus-url-parameters">See more on this parameter.</a></td></tr><tr><td><code>tpl</code></td><td>Optional</td><td>Checkout template code. Defaults to the template ID used in the previous order for the subscription.</td></tr><tr><td><code>qty</code></td><td>Optional</td><td>The quantity of the product offered as upgrade offer. Defaults to the minimum quantity set per product.</td></tr></tbody></table>


---

# 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.2checkout.com/shopping-carts/convertplus/upgrade-orders.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.