Checkout UI Extension is not getting installed on my DEV store

Retired Boards Appdev Extensions
,

Topic summary

A developer encountered an issue where their checkout UI extension (built with JavaScript React framework) worked correctly in preview mode but failed to install on their development store after deployment. When attempting installation via the app install link from the Distribution tab, error messages appeared instead of completing the installation.

Resolution Found:

  • One participant resolved the issue by adding proper scopes to the shopify.app.toml file
  • The original poster fixed their specific problem by adding callback URLs to the redirect_urls configuration in the shopify.app.toml file

Key Technical Details:

  • The extension functions properly during preview/development
  • Installation fails when using the generated distribution link
  • Configuration in shopify.app.toml file was the root cause
  • Screenshots were shared showing the error messages and configuration solutions

The issue appears resolved through proper configuration of the app’s TOML file, specifically around authentication scopes and redirect URLs.

Summarized with AI on November 12. AI used: claude-sonnet-4-5-20250929.
1

Hello Folks,

I’ve created a checkout UI extension to offer an upsell, and it works fine during the preview. However, after deployment, when I generate the app install link under the ‘Distribution’ tab and use that link to install the app on my development store, it displays the following messages instead of installing it:

Screenshot_24.png
Screenshot_24.png922×464 9.63 KB

Here’s the distribution tab:

iamfarhan_0-1708004379009.png
iamfarhan_0-1708004379009.png1483×517 34.4 KB

FYI, I’ve created the app in the Javascript React framework that runs fine in preview mode.

Please let me know how to resolve this issue.

Thanks so much

2

hey @iamfarhan , I have the same issue did you fix it ?

3

Hello Ahmed, not yet

4

Hi Farhan, I’ve found the solution. Simply add your scopes to the ‘shopify.app.toml’ file, and your app should be able to install. Let me know if this resolves your issue too

ahmezza_0-1708045218489.png

1 Like
5

Hi Ahmed, for me the issue was with the redirect_urls. I fixed this by adding the callback URLs in the ‘shopify.app.toml’ file, please see below:

iamfarhan_0-1708081528822.png
iamfarhan_0-1708081528822.png764×172 2.34 KB

1 Like