---
title: POS UI Extensions 2025-07 update - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/pos-ui-extensions-2025-07-update
  md: https://shopify.dev/changelog/pos-ui-extensions-2025-07-update.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

July 3, 2025

Tags:

* Action Required
* POS Extensions

# 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`](https://shopify.dev/docs/api/pos-ui-extensions/components/formattedtextfield) component. Update your code to use [`TextField`](https://shopify.dev/docs/api/pos-ui-extensions/components/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`](https://shopify.dev/docs/api/pos-ui-extensions/components/icon) component:

* For the [`size`](https://shopify.dev/docs/api/pos-ui-extensions/latest/components/icon#icon-propertydetail-size) property, we've deprecated: `'minor'`, `'major'`, `'spot'`, `'caption'`, `'badge'`. Use `'s'`, `'m'`, `'l'`, `'xl'` instead.
* For the [`name`](https://shopify.dev/docs/api/pos-ui-extensions/latest/components/icon#icon-propertydetail-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`](https://shopify.dev/docs/api/pos-ui-extensions/latest/components/icon#icon-propertydetail-name).

### Important Fixes

We've updated the [`pos.draft-order-details.block.render`](https://shopify.dev/docs/api/pos-ui-extensions/targets/draft-order-details/pos-draft-order-details-block-render) target to allow block components ([`BlockComponents`](https://github.com/Shopify/ui-extensions/blob/8e96f10736bd1c20628f94bfbb7b873d27fd5346/packages/ui-extensions/src/surfaces/point-of-sale/targets.ts#L24)). Previously, this target erroneously accepted action components ([`ActionComponents`](https://github.com/Shopify/ui-extensions/blob/8e96f10736bd1c20628f94bfbb7b873d27fd5346/packages/ui-extensions/src/surfaces/point-of-sale/targets.ts#L19)), 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`](https://shopify.dev/docs/api/pos-ui-extensions/apis/session-api) interface.
* Added an optional `currency` property to the [`Discount`](https://shopify.dev/docs/api/pos-ui-extensions/apis/cart-line-item-api#cartlineitemapi-propertydetail-cartlineitem) interface.
* Added an `executedAt` property to the [`BaseTransactionComplete`](https://shopify.dev/docs/api/pos-ui-extensions/targets/receipts/pos-receipt-footer-block-render#transactioncompletewithreprintdata-propertydetail-transaction) interface.
* Added optional `exchangeId` and `returnId` properties to the [`ReturnTransactionData`](https://shopify.dev/docs/api/pos-ui-extensions/targets/receipts/pos-receipt-footer-block-render#transactioncompletewithreprintdata-propertydetail-transaction) interface.
* Added a required `variantId` property to the [`ProductApi`](https://shopify.dev/docs/api/pos-ui-extensions/apis/product-api#productapi-propertydetail-variantid) interface.
* Added an optional `taxLines` property to the [`ShippingLine`](https://shopify.dev/docs/api/pos-ui-extensions/targets/post-transaction/pos-transaction-complete-event-observe#transactioncompletedata-propertydetail-transaction) interface.
* Added an optional `onBlur` handler to the [`SearchBar`](https://shopify.dev/docs/api/pos-ui-extensions/components/searchbar) component.
* Added an optional `tone` property to the [`Icon`](https://shopify.dev/docs/api/pos-ui-extensions/components/icon) component, and added new `name` and `size` options.

Additionally, in developer preview, we've introduced a [Storage API](https://shopify.dev/docs/api/pos-ui-extensions/apis/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](https://shopify.dev/docs/api/pos-ui-extensions/versions).