POS UI Extensions not deploying on active app version

Extensions
1

I recently implemented an POS UI extension in the latest version of my app (we’re migrating from legacy POS Links extensions).

The thing is, on development (running locally shopify app dev) it works pretty well on Shopify POS, but today we deploy it (using shopify app deploy) and the extensions don’t appear in the production Shopify POS app.

I created the POS UI extension using shopify cli.
I use “shopify app dev” command for development and testing.
Once I finished the development, finally I use “shopify app deploy” to deploy the new version with the POS UI extension.

The version with the new extension is released and active (as I see in the partner dashboard), but the extension just not appear in the app.

Is there any extra step I need to do for deploy the POS UI extensions? Has anyone experienced this too?

2

Hi! Have connected with the POS extensions team to see why this might be happening. Will let you know what I hear back.

3

Hi @Liam-Shopify,

We are also having the same issue.

Same as described by @chescko29, we have just deployed our POS ui extension and its not showing in the POS UI.

  1. App is embedded in the POS.
  2. Successfully deployed by CLI and released to merchants.
  3. Shows in the active version within the app releases section.

Is there something we are missing?

Thanks!

4

Hi @Jack.

Just to validate if we are using the same versions. What version of Shopify API and Shopify CLI are you using?

I’m working with:

Shopify CLI: 3.74.1
Shopify API: 2025-01
@shopify/ui-extensions: 2025.1.x
@shopify/ui-extensions-react: 2025.1.x

Maybe that info can be useful for @Liam-Shopify

5

@chescko29 and @Jack: I had what sounds like the same issue deploying POS UI extensions to a staging environment for our QA people to work on. I found that the issue was that the app I deployed to didn’t have the “embed app in Shopify POS” configuration option enabled:

image
image2666×832 181 KB

Once I changed this to “true” I was able to add my POS UI extensions, so it might be worth checking this setting (Shopify Partners portal → apps → your app → configuration → scroll down to the “POS” section).

6

Hi @AndyPye

This would not be our case because we already have that option enabled. It looks that is a bug or something.

Thanks.

7

Ah OK – just thought it was worth mentioning just in case. It might help some other developers to have the reminder visible here too :person_shrugging:

Hope you get a resolution to this soon!

1 Like
8

We are running the same setup as @chescko29, and the app is set up to be embeddable in POS as @AndyPye described.

Is there any news on what this issue could be @Liam-Shopify?

Another odd one is that a merchant sent us a screenshot of the extension (on the POS hardware), but it’s unavailable on any device we tested (a phone or emulator).

9

Hi guys.

Shopify Partner Support emailed me today after reviewing this topic:

After carefully reviewing the information you’ve shared and investigating potential causes, there are a few key areas to address to resolve the issue you’re experiencing.

First, ensure that the app is correctly embedded within Shopify POS. In your Partner Dashboard, go to the Extensions section of your app and confirm that the “Embed in POS” option is enabled. This ensures that the extension integrates properly with the POS interface.

Next, confirm that the extension is activated within the Shopify admin. From your Shopify admin, navigate to Sales Channels, then Point of Sale, and select Settings. In the POS apps section, locate the (Your Name App) app. From there, verify that the extension is added to the smart grid so it becomes accessible through the Shopify POS interface.

Additionally, double-check the deployment process and app versioning. Ensure that the latest deployed version is marked as active in the App Releases section of your Partner Dashboard. If the extension was deployed correctly using the shopify app deploy command, it should appear here as the active version.

For compatibility considerations, make sure all related dependencies align with the 2025-01 API version you’re currently using. Incompatible versions may cause the extension to function during development but fail to appear once deployed. If you haven’t already, review the POS UI Extensions documentation here:

https://shopify.dev/docs/api/pos-ui-extensions/2025-01/getting-started.

From a code perspective, verify that the extension manifest file and your app configuration match the requirements outlined in the documentation. For example, the POS UI extension should be correctly defined in the shopify.app.toml file. If there were recent changes to your app structure or configuration, re-running the shopify app dev command can help confirm if the extension still appears correctly in the development environment.

For me, the solution was confirm that the extension is activated within the Shopify admin.

This is not too much UX friendly for the merchants I think, but this was the reason our users did not see the extension working.

This is not clear on the documentation neither.

I hope it helps you.