Skip to main content

POS UI Extensions 2025-07 update

As of July 3, 2025, we've made the following updates to POS UI Extensions:

Breaking Changes

We've removed the deprecated FormattedTextField component. Update your code to use TextField instead.

FormattedTextField still works in POS 10.6.0, but will no longer function in POS 10.7.0.

Deprecations

We've deprecated the following property values on the Icon component:

  • For the size property, we've deprecated: 'minor', 'major', 'spot', 'caption', 'badge'. Use 's', 'm', 'l', 'xl' instead.
  • For the name property, we've deprecated 'arrow', 'available-at-other-locations', 'collections', 'connectivity-warning', 'delivery', 'home', 'image-placeholder', 'internet', 'menu', 'orders', 'products', 'shipment'. See valid values for IconName.

Important Fixes

We've updated the pos.draft-order-details.block.render target to allow block components (BlockComponents). Previously, this target erroneously accepted action components (ActionComponents), which are intended targets like pos.draft-order-details.action.render.

Additions

Along with the above deprecations and fixes, we've added the following:

  • Added a required posVersion property to the Session interface.
  • Added an optional currency property to the Discount interface.
  • Added an executedAt property to the BaseTransactionComplete interface.
  • Added optional exchangeId and returnId properties to the ReturnTransactionData interface.
  • Added a required variantId property to the ProductApi interface.
  • Added an optional taxLines property to the ShippingLine interface.
  • Added an optional onBlur handler to the SearchBar component.
  • Added an optional tone property to the Icon component, and added new name and size options.

Additionally, in developer preview, we've introduced a Storage API. This API gives UI extensions access to store data on the POS device where the extension is running.

Versions

All changes are available for POS UI Extensions version 2025-07 and POS app version 10.6.0. For complete version details, refer to the version log.

Was this section helpful?