Overview of July 2025 Updates
The latest July 2025 update for POS UI Extensions introduces several significant changes, including breaking changes, deprecations, fixes, and new additions. These updates are critical for ensuring compatibility and performance in your applications. Let’s dive into the specifics.
Breaking Changes
One major breaking change to note:
- The FormattedTextField component has been removed. Developers should replace instances of FormattedTextField with TextField.
- While FormattedTextField still operates in POS version 10.6.0, it will not function in POS version 10.7.0 and above.
Deprecations
The following properties have been deprecated and require updates:
Icon Component
- Size property: Deprecated values include 'minor', 'major', 'spot', 'caption', and 'badge'. Use 's', 'm', 'l', and 'xl' instead.
- Name property: Deprecated values include 'arrow', 'available-at-other-locations', 'collections', 'connectivity-warning', 'delivery', 'home', 'image-placeholder', 'internet', 'menu', 'orders', 'products', and 'shipment'. See valid values for IconName.
Important Fixes
This update resolves notable issues:
- Error in the pos.draft-order-details.block.render target has been addressed. Block components (BlockComponents) are now accepted properly instead of action components (ActionComponents).
New Additions
Exciting new features have been added in this release:
-
Session interface: Added a required
posVersionproperty. -
Discount interface: Added an optional
currencyproperty. -
BaseTransactionComplete interface: Added
executedAtproperty. -
ReturnTransactionData interface: Added optional
exchangeIdandreturnIdproperties. -
ProductApi interface: Added a required
variantIdproperty. -
ShippingLine interface: Added an optional
taxLinesproperty. -
SearchBar component: Added an optional
onBlurhandler. -
Icon component: Added an optional
toneproperty and new options for size and name.
Storage API (Developer Preview)
A Storage API has been introduced in developer preview, enabling UI extensions to store data locally on the POS device.
Version Compatibility
These updates are available for POS UI Extensions version 2025-07 and POS app version 10.6.0. For further details, refer to the version log.