# Upgrade guide — v19 to v20 — Subscriptions

Source: https://support.storeconnect.com/articles/upgrade-guide-v19-to-v20-subscriptions · Last modified 21 August 2026

Review this section if you use StoreConnect subscription products.

## Salesforce package changes

### Review: New fields on Product2

| Field | Purpose |
|---|---|
| `Subscription_Renewal_Order_Days__c` | Number of days for the subscription renewal term |
| `Subscription_Generate_Renewal_Order_Days__c` | Number of days before subscription end when the renewal order is automatically generated |

Review whether these fields should be added to your `Product2` page layouts for admins who configure subscription products. See [Subscription products](subscription-products) for full subscription product configuration reference.


### Review: New fields on Subscription__c

| Field | Purpose |
|---|---|
| `Renewal_Order_Date__c` | Date when the renewal order will be automatically generated |
| `Renewal_Order_Id__c` | Reference to the generated renewal Order |

Add these fields to your `Subscription__c` page layouts if your team monitors subscription records in Salesforce. See [Subscription Object Reference](subscription-object-reference) for the full field reference.

## Liquid changes

### Review: New subscription drop properties

The following properties are now available on the `subscription` Liquid drop. See [Subscription - Liquid Object Reference](subscription-liquid-object-reference) for the full drop reference.

| Property | Type | Description |
|---|---|---|
| `renewal_order` | Order | The Order associated with the next subscription renewal |
| `renewal_order_date` | Timestamp | Date when the renewal Order will be generated |

If your theme includes a subscription details or account subscriptions page, consider surfacing this data so customers can see when their renewal order will be created.

### Review: New translation keys

The default theme includes two new translation keys for the subscription index page.

| Key | Default value |
|---|---|
| `accounts.subscriptions.index.renewal_order` | Renewal Order |
| `accounts.subscriptions.index.no_renewal_order` | No renewal order |

If your theme overrides the subscriptions index template, add these keys to your theme translations if you are displaying renewal order information.

## Behavior changes

### Review: Automated renewal order creation

StoreConnect can now automatically create a Salesforce Order a set number of days before a subscription's billing date. The schedule is controlled by `Product2.Subscription_Generate_Renewal_Order_Days__c` on the subscription product. See [Subscription processing, payments and renewals](subscription-processing-payments-and-renewals) for full documentation on how subscription renewals work.

When the renewal Order is generated, `Subscription__c.Renewal_Order_Date__c` and `Renewal_Order_Id__c` are populated. The Order is created with `checkout_step` set to `"pending_renewal"`.

1. Review the `Subscription_Generate_Renewal_Order_Days__c` field on your subscription products. Set this field on any products where you want renewal orders generated automatically before the billing date.
2. Confirm the renewal order scheduled task is enabled in your StoreConnect configuration.
3. Test the renewal flow in a sandbox org before enabling in production.
4. If you have automation that processes subscription Orders, review whether it should treat `checkout_step == "pending_renewal"` orders differently from standard orders.
5. Update any order management SOPs to account for renewal orders being created automatically ahead of billing.

---

## Follow StoreConnect

- [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://getstoreconnect.com/partners)
- [News](https://getstoreconnect.com/articles/news)
- [Events](https://getstoreconnect.com/articles/events)
- [Feature Comparison](https://getstoreconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://getstoreconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

---

StoreConnect Support — https://support.storeconnect.com/articles/upgrade-guide-v19-to-v20-subscriptions