---
title: Targets
description: >-
  Targets define where your POS UI extensions appear within Shopify's Point of
  Sale interface and what capabilities they receive.
api_version: 2025-07
api_name: pos-ui-extensions
source_url:
  html: 'https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets'
  md: 'https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets.md'
---

# Targets

Targets define where your POS UI extensions appear within [Shopify's Point of Sale interface](https://shopify.dev/docs/apps/build/pos) and what capabilities they receive.

Targets serve specific purposes: some render persistent UI elements within existing screens, others provide interactive menu items or buttons, and some launch full-screen modal experiences for complex workflows.

Use this reference to explore all available targets and understand where they appear in the POS interface.

![Extension targets overview](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/targets-overview-hero-EQ3LjmEr.png)

***

## Home screen (smart grid)

The smart grid is the first screen merchants see when they open [the POS app](https://apps.shopify.com/shopify-pos). It provides quick access to essential functions and serves as the starting point for merchant activities.

**Use cases**: High-frequency actions, status displays, or entry points to workflows that merchants need daily.

[View home screen targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/home-screen)

##### Home screen tile

`pos.home.tile.render`

A tile target that displays as a clickable tile on the POS home screen smart grid.

##### Home screen action (modal)

`pos.home.modal.render`

An action target that displays as a full-screen modal when a home screen tile is tapped.

![Home screen tile target on POS smart grid](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/home-tile-render-b3-L7BvZ.png)

![Home screen modal action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/home-modal-render-D5BQjvAL.png)

***

## Cart details

The cart details screen appears when customers select items in a transaction to modify quantities, apply discounts, or access item-specific tools. This screen provides control over individual products during transaction building.

**Use cases**: Item-specific customizations, cart monitoring, or product configuration tools that improve line item management.

[View cart details targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/cart-details)

##### Cart details action (menu item)

`pos.cart.line-item-details.action.menu-item.render`

An action target that displays as a menu item on the cart line item details screen.

##### Cart details action (modal)

`pos.cart.line-item-details.action.render`

An action target that displays as a modal when a cart line item action menu item is tapped.

![Cart details menu item action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/cart-details-menu-item-render-WQcUz3bw.png)

![Cart details modal action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/cart-details-modal-render-4R-Rrmlt.png)

***

## Customer details

The customer details screen appears when merchants look up a customer during checkout or need to access customer history and profile information. This screen serves as the hub for customer management within POS, displaying customer data, purchase history, and contact details.

**Use cases**: Customer service capabilities, loyalty program integration, or tools for customer engagement and support during transactions.

[View customer details targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/customer-details)

##### Customer details block

`pos.customer-details.block.render`

A block target that displays inline content within the customer details screen.

##### Customer details action (menu item)

`pos.customer-details.action.menu-item.render`

An action target that displays as a menu item on the customer details screen action menu.

##### Customer details action (modal)

`pos.customer-details.action.render`

An action target that displays as a modal when a customer details action menu item is tapped.

![Customer details block target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/customer-details-block-render-DAsZIa2K.png)

![Customer details menu item action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/customer-details-menu-item-render-C5M6Rq_U.png)

![Customer details modal action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/customer-details-modal-render-DRjcbJbh.png)

***

## Draft order details

The draft order details screen appears when merchants access saved orders, quotes, or incomplete transactions that need to be finalized later. This screen displays draft order information, customer details, and line items for sales that haven't been completed.

**Use cases**: Quote management, approval workflows, or integration with external systems for draft order processing and completion.

[View draft order details targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/draft-order-details)

##### Draft order details block

`pos.draft-order-details.block.render`

A block target that displays inline content within the draft order details screen.

##### Draft order details action (menu item)

`pos.draft-order-details.action.menu-item.render`

An action target that displays as a menu item on the draft order details screen action menu.

##### Draft order details action (modal)

`pos.draft-order-details.action.render`

An action target that displays as a modal when a draft order details action menu item is tapped.

![Draft order details block target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/draft-order-block-render-BY_i0_jR.png)

![Draft order details menu item action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/draft-order-menu-item-render-TUZMJLb3.png)

![Draft order details modal action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/draft-order-modal-render-BAswaBFY.png)

***

## Order details

The order details screen appears when merchants access a completed transaction for customer service, refunds, or order fulfillment tasks. This screen displays transaction information including customer details, payment data, line items, and fulfillment status for completed sales.

**Use cases**: Order management, fulfillment tools, or integration with external systems for post-sale processing and customer support.

[View order details targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/order-details)

##### Order details block

`pos.order-details.block.render`

A block target that displays inline content within the order details screen.

##### Order details action (menu item)

`pos.order-details.action.menu-item.render`

An action target that displays as a menu item on the order details screen action menu.

##### Order details action (modal)

`pos.order-details.action.render`

An action target that displays as a modal when an order details action menu item is tapped.

![Order details block target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/order-details-block-render-D9oKyw0e.png)

![Order details menu item action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/order-details-menu-item-render-BYfP_PnY.png)

![Order details modal action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/order-details-modal-render-CQOvyY2S.png)

***

## Post-exchange

The post-exchange screen appears after merchants complete an exchange transaction. This screen displays the exchange summary including exchanged items, price adjustments, and exchange details, providing opportunities for customer service and follow-up actions.

**Use cases**: Exchange management, inventory tracking tools, or customer service features for product exchanges.

Beta

Post-exchange targets are part of the POS UI extensions [feature preview](https://shopify.dev/docs/api/feature-previews). This feature preview is invite-only and requires POS UI extensions version 2025-07 or higher and POS app version 9.31.0 or later.

[View post-exchange targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/post-exchange)

##### Post-exchange block

`pos.exchange.post.block.render`

A block target that displays inline content within the post-exchange screen.

##### Post-exchange action (menu item)

`pos.exchange.post.action.menu-item.render`

An action target that displays as a menu item on the post-exchange screen action menu.

##### Post-exchange action (modal)

`pos.exchange.post.action.render`

An action target that displays as a modal when a post-exchange action menu item is tapped.

![Post-exchange block target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/post-exchange-block-render-D0olucKe.png)

![Post-exchange menu item action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/post-exchange-menu-item-render-PJHxswnN.png)

![Post-exchange modal action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/post-exchange-modal-render-1t2QTs6x.png)

***

## Post-purchase

The post-purchase screen appears after merchants complete a sale, return, or exchange transaction. This screen displays the transaction summary and provides opportunities for follow-up actions, customer service, and revenue generation.

**Use cases**: Capturing additional information, customer service tools, or related transactions that improve the post-sale customer experience.

[View post-purchase targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/post-purchase)

##### Post-purchase block

`pos.purchase.post.block.render`

A block target that displays inline content within the post-purchase screen.

##### Post-purchase action (menu item)

`pos.purchase.post.action.menu-item.render`

An action target that displays as a menu item on the post-purchase screen action menu.

##### Post-purchase action (modal)

`pos.purchase.post.action.render`

An action target that displays as a modal when a post-purchase action menu item is tapped.

![Post-purchase block target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/post-purchase-block-render-DHXejkQi.png)

![Post-purchase menu item action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/post-purchase-menu-item-render-XSLfhYs7.png)

![Post-purchase modal action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/post-purchase-modal-render-c20DGnX4.png)

***

## Post-return

The post-return screen appears after merchants complete a return transaction. This screen displays the return summary including returned items, refund amounts, and return reason, providing opportunities for customer service and follow-up actions.

**Use cases**: Return-specific tools, refund processing, or customer service features for return workflows.

Beta

Post-return targets are part of the POS UI extensions [feature preview](https://shopify.dev/docs/api/feature-previews). This feature preview is invite-only and requires POS UI extensions version 2025-07 or higher and POS app version 9.31.0 or later.

[View post-return targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/post-return)

##### Post-return block

`pos.return.post.block.render`

A block target that displays inline content within the post-return screen.

##### Post-return action (menu item)

`pos.return.post.action.menu-item.render`

An action target that displays as a menu item on the post-return screen action menu.

##### Post-return action (modal)

`pos.return.post.action.render`

An action target that displays as a modal when a post-return action menu item is tapped.

![Post-return block target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/post-return-block-render-Df_kalFm.png)

![Post-return menu item action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/post-return-menu-item-render-YnqGeEp6.png)

![Post-return modal action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/post-return-modal-render-MjL_cRkf.png)

***

## Product details

The product details screen appears when merchants search for a product, scan a barcode, or browse inventory during a transaction. This screen displays product information including pricing, inventory levels, variants, and product specifications that merchants need to serve customers.

**Use cases**: Product understanding, additional product data, or product-specific tools that help merchants make informed decisions during transaction building.

[View product details targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/product-details)

##### Product details block

`pos.product-details.block.render`

A block target that displays inline content within the product details screen.

##### Product details action (menu item)

`pos.product-details.action.menu-item.render`

An action target that displays as a menu item on the product details screen action menu.

##### Product details action (modal)

`pos.product-details.action.render`

An action target that displays as a modal when a product details action menu item is tapped.

![Product details block target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/product-details-block-render-BGkLbrh5.png)

![Product details menu item action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/product-details-menu-item-render-CtCQMWN2.png)

![Product details modal action target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/product-details-modal-render-zOdzHi1W.png)

***

## Receipts

The receipt appears as the printed or digital output that customers receive after completing a transaction. This receipt displays transaction details, payment information, and store branding, providing the last touchpoint in the customer experience.

**Use cases**: Custom content in receipt headers and footers, branding opportunities, promotional messages, or transaction details that improve the customer experience.

Beta

Receipt targets are part of the POS UI extensions [feature preview](https://shopify.dev/docs/api/feature-previews). This feature preview is invite-only and requires POS UI extensions version 2025-04 or higher and POS app version 9.31.0 or later.

[View receipt targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/receipts)

##### Receipt block (header)

`pos.receipt-header.block.render`

A block target that displays custom content in receipt headers for printed and digital receipts.

##### Receipt block (footer)

`pos.receipt-footer.block.render`

A block target that displays custom content in receipt footers for printed and digital receipts.

![Receipt header block target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/receipts-header-block-render-CawGpwXn.png)

![Receipt footer block target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/receipts-footer-block-render-DWy10BWH.png)

***

## Transaction events

Transaction event targets operate in the background, responding to activities that occur during POS operations. These extensions don't display user interfaces but automatically react to merchant actions.

**Use cases**: Background processing, data synchronization, analytics collection, or automated responses that extend POS functionality without disrupting merchant workflows.

[View transaction events targets →](https://shopify.dev/docs/api/pos-ui-extensions/2025-07/targets/transaction-events)

##### Cart update event

`pos.cart-update.event.observe`

An event target that observes cart updates during active transactions.

##### Cash tracking start event

`pos.cash-tracking-session-start.event.observe`

An event target that observes when cash tracking sessions begin.

##### Cash tracking complete event

`pos.cash-tracking-session-complete.event.observe`

An event target that observes when cash tracking sessions complete.

##### Transaction complete event

`pos.transaction-complete.event.observe`

An event target that observes completed transactions (sales, returns, exchanges).

![Cart update event target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/transaction-cart-update-observe-DtmKjtR9.png)

![Cash tracking start event target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/transaction-tracking-session-start-observe-87wAnPeK.png)

![Cash tracking complete event target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/transaction-tracking-session-complete-event-observe-BgjIZntr.png)

![Transaction complete event target](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/transaction-complete-event-observe-DELMvtUj.png)

***