# Upgrade guide — v19 to v20 — POS

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

Review this section if you use StoreConnect point of sale (POS) features.

## Salesforce package changes

### Review: New POS objects

Version 20 adds five new objects to support POS layout management, quick actions, and custom views. Permissions are already included in the standard StoreConnect permission sets — no manual permission assignment is needed for the out-of-the-box sets.

| Object | Purpose | Standard permission sets |
|---|---|---|
| `Pos_Action_Group__c` | Groups POS action items into configurable menus | Administrator, Sync |
| `Pos_Action_Item__c` | Individual actions within a POS action group | Administrator, Sync |
| `Pos_Layout__c` | Defines POS terminal layout configurations | Administrator, Sync |
| `Pos_Layout_Field__c` | Individual fields within a POS layout | Administrator, Sync |
| `Pos_View__c` | Custom view configurations for the POS terminal | Administrator, Sync |

See [POS Action Group Object Reference](pos-action-group-object-reference), [POS Action Item Object Reference](pos-action-item-object-reference), [POS Layout Object Reference](pos-layout-object-reference), [POS Layout Field Object Reference](pos-layout-field-object-reference), and [POS View Object Reference](pos-view-object-reference) for full field details on each object. If you have custom permission sets, assess whether those sets should include access to the new objects.

### Review: Pos_Action_Item__c field names

Several `Pos_Action_Item__c` fields were added and renamed during the v20 development cycle. Since these objects are new in v20, you'll be unaffected if you're upgrading now from v19. But if you are upgrading from one v20 to another v20 version, and you are building new automation or integrations against `Pos_Action_Item__c`, use the current API names in the table below. See [POS Action Item Object Reference](pos-action-item-object-reference) for the full field reference.

| Deprecated API name | Current API name |
|---|---|
| `Label__c` | `Display_Name__c` |
| `Parent_Action_Group_Id__c` | `Parent_Pos_Action_Group_Id__c` |
| `Child_Action_Group_Id__c` | `Child_Pos_Action_Group_Id__c` |
| `Next_Action_Item_Id__c` | `Next_Pos_Action_Item_Id__c` |


## Behavior changes

### Review: POS Dashboard renamed to Home

The POS main screen is now called **Home**. Update any internal documentation or training materials that refer to the POS Dashboard. See [Set up POS](admin-set-up-pos) for current POS setup documentation.

### Review: Returns and refunds 

The returns mechanism has been reworked with UI improvements and better offline support. Returns can now be initiated when the terminal is offline. See [Item returns - refund and exchange at POS](returns-refund-exchange-at-pos) for the current returns process.

1. After upgrading, test a return transaction to confirm the mechanism works as expected in your environment.
2. Note that returns no longer increase the Available to Sell quantity on products. See [Upgrade guide — v19 to v20 — E-commerce](upgrade-guide-v19-to-v20-ecommerce) for details on adjusting inventory.

### Review: Line item and order level discounts

The discount model for both line item and order-level discounts has been reworked. See [Adjust prices at the POS checkout](discounts-and-price-overrides) for current discount documentation.

1. After upgrading, test your discount scenarios (line item and order level) to confirm expected behavior.
2. If you have automation or custom flows that interact with POS discounts, review those workflows against the updated model.

### Review: Offline deletion sync

When the POS comes back online after a period offline, it now fetches and processes record deletions from the server and removes them from the local IndexedDB cache. This keeps the local dataset consistent with Salesforce after connectivity is restored.

No configuration is required. If you have custom offline behavior that depends on deleted records persisting in the local cache, review that behavior after upgrading.

---

## 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-pos