---
title: Register details
description: >-
  The register details screen displays information about the current register
  and cash drawer status. This screen provides access to cash management
  operations and register-specific tools for retail staff.
api_version: 2026-01
api_name: pos-ui-extensions
source_url:
  html: >-
    https://shopify.dev/docs/api/pos-ui-extensions/latest/targets/register-details
  md: >-
    https://shopify.dev/docs/api/pos-ui-extensions/latest/targets/register-details.md
---

# Register details

The register details screen displays information about the current register and cash drawer status. This screen provides access to cash management operations and register-specific tools for retail staff.

### Use cases

* **Cash drawer operations:** Open drawers for manual verification outside transactions.
* **Register information:** Display cash totals, shift summaries, and till balances.
* **Cash management:** Launch workflows for deposits, withdrawals, and reconciliation.
* **Compliance features:** Implement dual-authorization, audit trails, and cash limit alerts.

![Register details targets overview](https://shopify.dev/assets/assets/images/api/pos-ui-extensions/targets-overview-images/register-targets-DexyINWh.png)

***

## Register details targets

Use these targets for register-specific customizations, cash management operations, or compliance tools that enhance cash handling workflows.

### Register details action (menu item) target

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

Renders a single interactive button component as a menu item in the register details action menu. Use this target for register-specific operations like opening the cash drawer, launching cash management workflows, or accessing register verification tools.

Extensions at this target can access the Cash Drawer API to control cash drawer operations. Menu items typically invoke `shopify.action.presentModal()` to launch the companion [modal](#register-details-action-modal-) for complete workflows.

### Support Components (1) APIs (12)

### Supported components

* [Button](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/actions/button)

### Available APIs

* [Action API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/action-api)
* [Camera API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/camera-api)
* [Cash Drawer API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/cash-drawer-api)
* [Connectivity API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/connectivity-api)
* [Device API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/device-api)
* [Locale API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/locale-api)
* [Pin​Pad API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/pinpad-api)
* [Print API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/print-api)
* [Product Search API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/product-search-api)
* [Session API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/session-api)
* [Storage API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/storage-api)
* [Toast API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/toast-api)

Examples

### Examples

* ####

  ##### Description

  Add an interactive menu item to the register details action menu for register-specific operations. This example shows how to create a menu item that accesses register data and launches modal workflows for tasks like cash management, shift reporting, or register configuration.

  ##### jsx

  ```jsx
  import {render} from 'preact';

  export default async () => {
    render(<Extension />, document.body);
  };

  const Extension = () => {
    return <s-button onClick={() => shopify.action.presentModal()} />;
  };
  ```

### Register details action (modal) target

`pos.register-details.action.render`

Renders a full-screen modal interface launched from register details [menu items](#register-details-action-menu-item-). Use this target for complex register workflows that require forms, multi-step processes, or detailed information displays beyond what a simple button can provide.

Extensions at this target have access to the Cash Drawer API to control cash drawer operations and support workflows with multiple screens, navigation, and interactive components.

### Support Components (34) APIs (12)

### Supported components

* [Badge](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/feedback-and-status-indicators/badge)
* [Banner](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/feedback-and-status-indicators/banner)
* [Box](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/box)
* [Button](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/actions/button)
* [Choice list](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/choice-list)
* [Clickable](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/actions/clickable)
* [Date field](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/date-field)
* [Date picker](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/date-picker)
* [Date spinner](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/date-spinner)
* [Divider](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/divider)
* [Email field](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/email-field)
* [Embed](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/media-and-visuals/embed)
* [Empty state](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/empty-state)
* [Heading](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/heading)
* [Icon](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/media-and-visuals/icon)
* [Image](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/media-and-visuals/image)
* [Link](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/actions/link)
* [Modal](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/feedback-and-status-indicators/modal)
* [Number field](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/number-field)
* [POS block](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/pos-block)
* [Page](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/page)
* [POS block](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/pos-block)
* [Scroll box](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/scroll-box)
* [Search field](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/search-field)
* [Section](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/section)
* [Spinner](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/feedback-and-status-indicators/spinner)
* [Stack](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/stack)
* [Switch](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/switch)
* [Tabs](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/tabs)
* [Text](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/text)
* [Text area](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/text-area)
* [Text field](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/text-field)
* [Time field](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/time-field)
* [Time picker](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/time-picker)

### Available APIs

* [Camera API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/camera-api)
* [Cash Drawer API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/cash-drawer-api)
* [Connectivity API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/connectivity-api)
* [Device API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/device-api)
* [Locale API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/locale-api)
* [Pin​Pad API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/pinpad-api)
* [Print API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/print-api)
* [Product Search API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/product-search-api)
* [Scanner API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/scanner-api)
* [Session API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/session-api)
* [Storage API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/storage-api)
* [Toast API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/toast-api)

Examples

### Examples

* ####

  ##### Description

  Build a full-screen modal workflow launched from a register details action menu item. This example demonstrates creating register-specific experiences with multi-step processes, forms, and register data access for operations like cash drawer management or shift reports.

  ##### jsx

  ```jsx
  import {render} from 'preact';

  export default async () => {
    render(<Extension />, document.body);
  };

  const Extension = () => {
    return (
      <s-page heading="Register Details Action">
        <s-scroll-box>
          <s-text>
            This is a action extension on the register details screen
          </s-text>
        </s-scroll-box>
      </s-page>
    );
  };
  ```

### Register details block target

`pos.register-details.block.render`

Renders a custom section directly within the register details screen. Use this target to display register-specific information or provide quick access to register operations without requiring a separate modal interface.

Extensions at this target appear inline on the register details screen and can include interactive elements like buttons in secondary action slots. This target is ideal for displaying register status information, quick actions, or alerts that should be immediately visible.

### Support Components (15) APIs (12)

### Supported components

* [Badge](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/feedback-and-status-indicators/badge)
* [Box](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/box)
* [Button](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/actions/button)
* [Date picker](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/date-picker)
* [Date spinner](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/date-spinner)
* [Heading](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/heading)
* [Icon](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/media-and-visuals/icon)
* [Image](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/media-and-visuals/image)
* [Modal](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/feedback-and-status-indicators/modal)
* [POS block](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/pos-block)
* [POS block](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/pos-block)
* [Section](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/section)
* [Stack](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/stack)
* [Text](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/layout-and-structure/text)
* [Time picker](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/forms/time-picker)

### Available APIs

* [Action API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/action-api)
* [Camera API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/camera-api)
* [Cash Drawer API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/cash-drawer-api)
* [Connectivity API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/connectivity-api)
* [Device API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/device-api)
* [Locale API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/locale-api)
* [Pin​Pad API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/pinpad-api)
* [Print API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/print-api)
* [Product Search API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/product-search-api)
* [Session API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/session-api)
* [Storage API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/storage-api)
* [Toast API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/standard-apis/toast-api)

Examples

### Examples

* ####

  ##### Description

  Add a custom information section to the register details screen for displaying supplementary register data. This example shows how to create a block that provides additional register information, cash status, or shift details alongside standard register details.

  ##### jsx

  ```jsx
  import {render} from 'preact';

  export default async () => {
    render(<Extension />, document.body);
  };

  const Extension = () => {
    return (
      <s-pos-block>
        <s-text>This is a block extension on the register details screen</s-text>
        <s-button
          slot="secondary-actions"
          onClick={() => shopify.cashDrawer.open()}
        >
          Open drawer
        </s-button>
      </s-pos-block>
    );
  };
  ```

***

## Best practices

* **Control cash drawer access appropriately:** Ensure cash drawer operations are protected with appropriate authorization checks and comply with your security requirements. Consider implementing PIN verification, manager approval, or audit logging for cash drawer operations initiated by your extension.
* **Show clear register status information:** When displaying register information in block extensions, ensure the data is current and clearly labeled. Show relevant details like current shift totals, last cash verification time, or pending cash management tasks that help staff understand the register state at a glance.
* **Provide immediate feedback for operations:** Show clear success or error messages when performing cash drawer operations or other register actions. Use toast notifications or banner messages to confirm actions like "Cash drawer opened successfully" or "Unable to open drawer: hardware error."
* **Handle hardware errors gracefully:** Cash drawer operations depend on connected hardware that may be unavailable or malfunctioning. Implement error handling that explains the issue clearly and suggests resolution steps, like "Cash drawer not responding. Check hardware connections and try again."
* **Use action-oriented labels:** Use clear, action-oriented labels for buttons and menu items that describe what the extension will do. Use "Open cash drawer" or "Start cash count" instead of generic labels like "Cash management app" or "Register tools."
* **Support offline scenarios:** Consider that register operations may need to work when connectivity is limited. Use the Connectivity API to detect network status and either queue operations for later sync or clearly communicate when features require network access.

***

## Limitations

* You can only render one [button](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/polaris-web-components/actions/button) component for each POS UI extension using the action (menu item) target.

* Cash drawer operations require compatible hardware connected to the POS device. The [Cash Drawer API](https://shopify.dev/docs/api/pos-ui-extensions/2026-01/target-apis/platform-apis/cash-drawer-api) will return an error if no cash drawer is connected or if the hardware is unavailable.

* Register details screen access is controlled by Shopify POS permissions. Extensions at these targets will only appear for staff members with appropriate permissions to access register management features.

***