Unable to set up iOS universal link / android app link

We’ve been trying to set up iOS universal link / Android app link for our site (https://bai-more-chicken.myshopify.com/) but unable to do so. Things we tried:

  1. Manually setting app id / sha256 in the admin/settings/app/configure page - we saved the changes successfully but the /apple-app-site-association or /.well-known/assetlinks.json files are not present on our site

  2. Using the mobile_platform_applications Admin API - we kept getting {“errors”:“Not Found”} errors.

Would appreciate any help with this matter! Thanks!

1 Like

Resolved - “You must use a custom domain to integrate shared web credentials with Shopify” - https://shopify.dev/api/admin-rest/2022-04/resources/mobileplatformapplication

Has anyone successfully used this to create a deep link? I’m finding very scarce information and Shopify’s support was again predictably useless telling me they don’t know how either and to just check these forums…

1 Like

Hi, can you please provide steps for how this can be used for iOS universal links? The linked post doesn’t provide any info.

1 Like

Hey @dev-223322-ios ,

Taking a look at our documentation here: https://shopify.dev/docs/api/admin-rest/2024-04/resources/mobileplatformapplication , the majority of the resources link directly to Apple’s developer documentation.

If that doesn’t help, let us know a little bit about where you’re getting stuck on the Shopify side and we’ll see what we can find out for you.

  • Kyle G.

The first step in this documentation is adding the scope “mobile_platform_applications”. Can’t find that scope anywhere and there is no documentation for it. How do we add that scope?

Both the android and apple links in that page show that it is required to place a file in the root of the website in the .well-known directory.

This is not possible currently in shopify as we do not have access to that directory.

https://developer.apple.com/documentation/xcode/supporting-associated-domains?language=objc

I would link the android page but it appears google deleted that page as it now redirects to a generic search page for “open by default”.

Hi @dev-223322-ios ,

The mobile_platform_applications scope that is required for this endpoint, is a requested scope and is something that Shopify Partner Support will need to enable manually on your Partner App.

To request this scope, please log into your Partner Dashboard, and click the support link in the navigation menu, then click the Contact Partner Support button to reach out to our live Partner Support Specialists who can help enable this scope on your app!

I hope this helps, and I hope you have a great day :slightly_smiling_face:

Hi @joeybab3 ,

I’ve discussed this with our developers further, as this is not something that is made very clear in our Shopify.dev docs, but the association file to be added to the .well-known directory, as mentioned in the Apple Docs, is actually generated and added to the necessary domain directory automatically when you create the mobile platform application via the REST Admin API with the POST mobile_platform_applications.json call.

This call and the arguments it accepts is described further in our Shopify.dev docs:

It is also important to know that at this time, we do not currently support all of the configuration options that Apple has available for associated domains, and we are currently limited to the arguments of the POST mobile_platform_applications.json call mentioned above.

I hope this helps, and I hope you have a great day :slightly_smiling_face:

Hi, Thanks for your update, we could not find a more complete answer to this problem anywhere else

can you please confirm if my understanding is correct?

  1. we need to create an app in our shopify store which is connected to the domain for which we need to launch the mobile app. (through Settings → Apps and sales channels)

  2. configure Admin API Integration for this app

  3. request support to add mobile_platform_applications scope for this app (https://shopify.dev/docs/api/admin-rest/2024-04/resources/mobileplatformapplication)

  4. once support adds this scope, make REST Admin API call to create the entry for android and ios apps (https://shopify.dev/docs/api/admin-rest/2024-04/resources/mobileplatformapplication#post-mobile-platform-applications)

Thanks in advance