Skip to content
Log in

Upgrade guide — v20 to v21

On this page

v21 is a significant release with major updates across promotions, POS, and payments, and introduces StoreConnect Bundles as a new feature. This guide gives you a plain-English overview of what has changed, followed by detailed upgrade steps in each subsection.

View the full Version 21 release notes for feature details and breaking changes.

Advanced promotions

StoreConnect v21 introduces a new Advanced promotions engine with a dedicated Salesforce data model. Nine new objects support the full promotion lifecycle: Promotion2__c, Condition__c, Reward__c, Cart_Promotion2__c, Promotion2_Condition__c, Promotion2_Product_Scope__c, Promotion2_Usage__c, Reward_Usage__c, and Order_Item_Reward__c. The engine supports promo codes, auto-applied promotions, free product rewards, and free shipping rewards. Permissions for all nine objects are included in the standard StoreConnect permission sets.

StoreConnect Bundles

v21 introduces StoreConnect Bundles, a native bundle solution for stores that do not use or need Salesforce CPQ. Products can be flagged as bundle-only via their pricebook entry, preventing them from being added to a cart directly and reserving them for use as bundle components only.

Multi-channel shipping and tax

Shipping rates and tax providers can now be scoped to specific channels. The new Channels__c field on Shipping_Rate__c and Tax_Provider__c specifies whether the rate or provider applies to the web store, the POS, or both. Existing records are automatically backfilled with both channels during the package upgrade.

Multi-gateway refunds

Refund support has been extended to a wider range of payment gateways, including Adyen, ZippayAu, Windcave, Tyro, PayWay, and CyberSource. These gateways previously required refunds to be processed outside StoreConnect.

POS improvements

v21 includes a major overhaul of the POS sync system. Sync now uses cursor-based pagination, improving reliability and removing the previous 72-hour window limitation on order retrieval. A new Register_Shift_Id__c field on Payment__c links payments to POS register shifts for end-of-shift reconciliation. New outlet and register Liquid drops are available in POS templates.

Custom objects in Liquid

Salesforce custom objects can now be synced to the web store and queried using Liquid templates, enabling data from any synced custom object to be surfaced on store pages.

Voucher enhancements

Vouchers now support an activation deadline via the new Activate_Before_Datetime__c field on Voucher__c. Voucher audit logging has been added, and asset linking is now supported.

Subscription improvements

New delinquency tracking fields on Subscription__c provide visibility into subscriptions that have missed payment cycles. eWay v2 subscriptions now support 3DS token rotation.

ZippayAu

The legacy Zippay v1 API integration has been replaced with ZippayAu. If your store uses Zippay, review the Payments section of this guide before upgrading.

Deprecated metadata cleanup

v21 removes several fields that are no longer used by StoreConnect. After upgrading, these fields remain in your org until you manually delete them. Running the cleanup is recommended to keep your org tidy and avoid confusion with unused fields appearing in Salesforce.

Warning: Deleting deprecated metadata permanently removes the fields and all data stored in them. Review each field below before proceeding. If any field still holds data you rely on, export or migrate it first — this action cannot be undone.

The following fields are removed in v21:

s_c__Store__c - s_c__Pay_By_Account_Enabled__c — Controlled whether Pay By Account was enabled on the store. If your store has used this feature, confirm it is no longer needed before deleting.

s_c__Outlet_Stock_Location__c - s_c__Priority__c — Previously used to set a priority order for outlet stock locations. If you have assigned priorities, note your current values before proceeding — they will be permanently lost.

s_c__Pos_Layout__c - s_c__Grid_Columns__c — Previously defined the number of columns in a POS layout grid. POS layout grid configuration has been redesigned in v21. - s_c__Grid_Rows__c — Previously defined the number of rows in a POS layout grid. POS layout grid configuration has been redesigned in v21.

s_c__Trait_Category__c - s_c__Display_As_Filter_Top_Level__c — Controlled whether a trait category appeared as a top-level filter. If you have trait categories configured this way, note your current setup before deleting.

Follow the How to delete deprecated metadata guide to deploy the cleanup zip file using Workbench.

Upgrade steps

Work through the sections that apply to your implementation:

Was this article helpful?

Was this article helpful?