---
title: Troubleshooting
description: Troubleshooting log for the POS UI Extensions package. Listed are some possible errors and resolutions to help aid in the event of unexpected error messages.
api_version: 2025-10
api_name: pos-ui-extensions
source_url:
  html: https://shopify.dev/docs/api/pos-ui-extensions/latest/troubleshooting
  md: https://shopify.dev/docs/api/pos-ui-extensions/latest/troubleshooting.md
---

# Troubleshooting

Troubleshooting log for the POS UI Extensions package. Listed are some possible errors and resolutions to help aid in the event of unexpected error messages.

## Extension QR code does not work on Android

### Resolution

Android devices can have a restriction on how deep links are handled. To resolve this issue, you can use one of the following options:

1. Connect the device to your computer. Use Android Studio to open your deep link by running the following command: adb shell am start "com.shopify.pos\://pos-ui-extensions?url=

2. Download and use a deep link opener app from Play Store.

### Examples

* #### Examples

  ##### Example 1

  ```text
  Unable to access "..."

  It looks like you don't have access to this store. Contact the store administrator for access.
  ```

  ##### Example 2

  ```text
  This site can't be reached

  Check if there is a typo in com.shopify.pos.
  ```

## Package resolution failed

### Resolution

This error is most likely from missing a dependency in package.json in the app root. Try re-installing your dependencies and running the app again.

### Examples

* #### Example

  ##### Default

  ```text
  ✘ [ERROR] Could not resolve "@preact/signals"

  You can mark the path "@preact/signals" as external to exclude it from the bundle, which will remove this error.
  ```