404 on Universal Links (.well-known/apple-app-site-association)

Technical Q&A

Topic summary

A developer is encountering a 404 error when attempting to access the .well-known/apple-app-site-association file needed for Universal Links (iOS) and App Links (Android) configuration.

Setup Details:

  • Following official Shopify documentation for custom storefronts
  • Configuration attempted through Shopify’s custom app API credentials page
  • 404 occurs on both the myshopify.com subdomain and custom domain

Current Status:

  • The issue remains unresolved
  • Developer questions whether documentation is incomplete or missing critical steps
  • A second user reports experiencing the identical problem

No solutions or workarounds have been identified in the discussion yet.

Summarized with AI on October 28. AI used: claude-sonnet-4-5-20250929.
1

We are trying to setup Universal Links (iOS) & App Links (Android) and are configuring a custom app to do this at [1], for which we followed the documentation at [2]/[3]. However, after following the documentation to the letter there is still a 404 when loading “.well-known/apple-app-site-association” from both the oursubdomain.myshopify .com domain & the custom domain.

What is going on with this? Is the documentation missing steps?

[1] = https://domain.myshopify.com/admin/apps/development/0/api_credentials (redacted domain & app id)

[2] = https://shopify.dev/custom-storefronts/tools/ios#set-up-universal-links

[3] = https://shopify.dev/custom-storefronts/tools/android#step-3-set-up-android-app-links

3 Likes
2

Hello, have you resolved the problem? What was the issue? It seems that I have exactly the same problem.