Upgrade guide — v19 to v20 — Subscriptions
On this page
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 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 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 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 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".
- Review the
Subscription_Generate_Renewal_Order_Days__cfield on your subscription products. Set this field on any products where you want renewal orders generated automatically before the billing date. - Confirm the renewal order scheduled task is enabled in your StoreConnect configuration.
- Test the renewal flow in a sandbox org before enabling in production.
- If you have automation that processes subscription Orders, review whether it should treat
checkout_step == "pending_renewal"orders differently from standard orders. - Update any order management SOPs to account for renewal orders being created automatically ahead of billing.