---
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/posts/pos-ui-extensions-2025-07-update'
  md: 'https://shopify.dev/changelog/posts/pos-ui-extensions-2025-07-update.md'
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: POS Extensions
      handle: pos-extensions
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2025-06-25T12:21:25-04:00'
  postedAt: '2025-07-03T12:00:00-04:00'
  updatedAt: '2025-07-03T14:21:25-04:00'
  effectiveAt: '2025-07-01T12:00:00-04:00'
---

July 3, 2025

# POS UI Extensions 2025-07 update

DateJuly 3, 2025

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[POS Extensions](https://shopify.dev/changelog?api_type=pos-extensions)

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).