Hi, I’m near the finish line for submitting my app and I’ve run into two final issues on the app submission prep page. The API Health issue I think is resolved, need to wait several days with no deprecated calls. Just added this in case someone knows how I might be missing something there.
The 2nd one is a problem, worked on it for many hours. The app works/installs perfectly embedded. But still showing the error message. Full message below. Listed as a yellow warning, not as a fail, as you can see.
Any help would be appreciated!
Joe
Navigation error on install
During an automated check, your app didn’t successfully redirect to a merchant user interface after authentication. The app responded with an unexpected URL. Learn more about installation requirements.
Can you confirm whether you’re using Shopify Managed Installation or implementing OAuth authorization code grant manually?
My hunch based on the app grant URL returned in the Actual Url field you shared, is that your app configuration file is missing the use_legacy_install_flow tag. When this is excluded, it defaults to the managed installation where it expects to be redirecting to your application_url without the scopes grant.
Fr context, the recommended method is Shopify Managed Install:
This provides the following advantages for the developer and user:
Improved performance: No browser redirects during installation or updates.
Less complexity: Embedded apps can use token exchange to acquire access tokens, and will no longer need to implement authorization code grant for installation or access scope changes.
Improved user experience: Faster installations and updates, and no screen flickering.
Hi Kyle, Thanks for the quick response. So…delete my current app and create a new one with Shopify Managed install? I thought I did this, I’ll check. Can I fix my current app? Joe
Hi, I’ve encountered the same problem, and I hope you can help me too.
I also failed this automatic check. Immediately redirects to app UI after authentication
I found that a link format like app/grant is the one for Shopify Managed Installation. However, the automatic check says it doesn’t redirect to the app’s homepage.
This is the code for my application configuration:
# Learn more about configuring your app at https://shopify.dev/docs/apps/tools/cli/configuration
client_id = "xxx"
name = "xxx"
application_url = "https://xxx.com"
embedded = true
[webhooks]
api_version = "2025-07"
[[webhooks.subscriptions]]
topics = [ "orders/create", "orders/delete", "orders/updated"]
uri = "https://xxx/api/v1/shopify/webhook/order"
[[webhooks.subscriptions]]
topics = [ "shop/update" ]
uri = "https://xxx/api/v1/shopify/webhook/shop"
[[webhooks.subscriptions]]
topics = [ "app/uninstalled" ]
uri = "https://xxx/api/v1/shopify/webhook/app_uninstall"
[[webhooks.subscriptions]]
compliance_topics = [ "customers/data_request", "customers/redact", "shop/redact" ]
uri = "https://xxx/api/v1/shopify/webhook/compliance"
[access_scopes]
# Learn more at https://shopify.dev/docs/apps/tools/cli/configuration#access_scopes
scopes = "read_locations,read_inventory,read_locales,read_markets_home,read_assigned_fulfillment_orders,read_customers,read_draft_orders,read_merchant_managed_fulfillment_orders,read_orders,read_third_party_fulfillment_orders,write_assigned_fulfillment_orders,write_customers,write_draft_orders,write_merchant_managed_fulfillment_orders,write_orders,write_third_party_fulfillment_orders"
[auth]
redirect_urls = [ ]
