Is it possible to edit /.well-known files? [mobile deeplinking/Buy SDK]

[mzielu]

I am trying to implement deep linking in my mobile apps, which use Shopify Theme stores. To do this, it is necessary to properly configure the files located at /.well-known/assetlinks.json and /.well-known/apple-app-site-association.

Is it possible to do that on Shopify? I’ve read a lot of documentation and threads here but haven’t found a proper solution. That’s why I have a few questions. If you know the answer to any of them, please don’t hesitate to share it with me 🙂

1. In order to properly configure the iOS/Android Buy SDK, is it required that the store is not password-protected?

2. Is it possible to edit the assetlinks.json and apple-app-site-association files generated when using the Buy SDKs?

3. Is it possible to successfully redirect the assetlinks.json and apple-app-site-association files using the URL redirect feature in the Shopify admin panel?

4. Have you managed to solve any of the above issues in a different way? If so, how did you do it?

Thank you in advance for the help!

[topnewyork]

Hello @mzielu ,

Shopify doesn’t allow direct access to .well-known/ files like assetlinks.json or apple-app-site-association.

Host these files on an external server (like Firebase, Netlify, or Vercel) using a subdomain — for example: links.yourstore.com/.well-known/assetlinks.json

Then, use that subdomain for deep linking in your app.

And Yes, your store must be public (not password protected) for deep links and SDKs to work properly.
Shopify URL redirects won’t work for .well-known/ paths.

[mzielu]

Thank you, @topnewyork for the answer. Just to be clear: there’s no way to enable deep linking for URLs like mzielu-store.myshopify.com/something, right? I have to do it this way instead: subd.mzielu-store/something? Also, I assume I’ll need to implement redirect logic for non-deep linking scenarios as well.

[topnewyork]

Hello @mzielu ,

Correct — deep linking won’t work directly on mzielu-store.myshopify.com  because Shopify doesn’t support serving  .well-known/  files.

You’ll need to host them on a custom subdomain like   links.mzielu-store.com , and point your app there for deep linking.

Also yes, handling fallback logic for non-deep link users inside the app is necessary to ensure smooth navigation.

[mzielu]

Thank you @Sunnytech for the answer. Just to be clear: there’s no way to enable deep linking for URLs like mzielu-store.myshopify.com/something, right? I have to do it this way instead: subd.mzielu-store/something? Also, I assume I’ll need to implement redirect logic for non-deep linking scenarios as well.