I have an app clip installed via TestFlight. My AASA file is configured correctly (per 'Domain Status' in TestFlight). I want to be able to run the app clip flow (app clip card showing and app clip card launched) by invoking UIApplication.shared.open(url) from a different app, or by pressing the URL from notes app. This doesn't seem to work. The only thing I am able to do is run the flow when scanning a proper QR code after configuring Local Experience with the matching parameters. But as stated above, the flow will not work when invoking the URL from a different app. Is the proper way to fix this is to define an HTML page for that URL path that contain the <meta> element with app-clip-bundle-id attribute that will match the Local Experience configuration? Is there another way to make this flow work with TestFlight releases? what are my options?
Invoking app clip, that was installed from TestFlight, from a different app.
Thanks for the post. I would like to ask you more information about the AASA file and where is stored as well as when the app is installed in your device is when the AASA file gets downloaded and installed/registered. You can go over the troubleshooting guide and get the logs from the swcutil.txt file inside the sysdiagnose wil give you the information. Please check the Tech Note at TN3155: Debugging universal links | Apple Developer Documentation#Debug-through-sysdiagnose
While the AASA file verification in TestFlight confirms your entitlement to handle App Clip URLs, the system might not always behave identically to a production-released app clip, please test with the Notes app.
Ensure that your AASA file is correctly configured for your App Clip and can be found when calling https://<your_domain>/.well-known/apple-app-site-association in all your tests (you said this is working OK). The AASA file tells iOS which URL paths are associated with your app clip. iOS does a check against the path and the bundle identifier to see whether the URL is valid.
Make sure your Local Experience is configured such that the URL used on the HTML page matches the URL configured in the local experience. The Local Experience setting is mandatory in order for your App Clip URL to work when using QR codes and other visual elements.
Double-check your apple-app-site-association file. Make certain that the file includes the correct paths and associated App Clip bundle identifier. json
Please do read and go over the steps on the Tech Note and provide me the AASA file as well if you can.
Thanks
Albert Pascual Worldwide Developer Relations.
I have an app clip installed via TestFlight. My AASA file is configured correctly (per 'Domain Status' in TestFlight). I want to be able to run the app clip flow (app clip card showing and app clip card launched) by invoking UIApplication.shared.open(url) from a different app, or by pressing the URL from notes app.
Launching the App Clip experiences you configure for testing through the TestFlight app doesn't show an App Clip card.
To view the App Clip card, register a local experience on your test device. For more information, see Test invocations with a local experience and Create App Clip experiences for testers in TestFlight.
To launch your App Clip from another app, see Launching another app’s App Clip from your app.
Hi, Thank you for the reply, here is more information: This AASA file is already running for many years. it's at&t AASA file, it can be found here: https://www.att.com/.well-known/apple-app-site-association I recently added the appclip section:
"appclips": {
"apps": ["7QP83HJ33U.com.att.numverify.clip"]
}
and a universal link addition (which works fine, the only problem is launching the app clip via URL in notes app):
{
"appID": "7QP83HJ33U.com.att.numverify",
"components": [
{
"/": "/numverify/appclip/*"
}
]
}
According to https://app-site-association.cdn-apple.com/a/v1/www.att.com) it is already updated in Apple CDN. I have reinstalled the app clip multiple times since then.
Here is what I found in swcutils_show.txt file that is related to the app clip:
Service: appclips App ID: 7QP83HJ33U.com.att.numverify.clip App Version: 2.0 App PI: <LSPersistentIdentifier 0xb0cf67d00> { v = 0, t = 0x8, u = 0x914, db = 22E62DAB-9CF1-485C-A697-006229CE874E, {length = 8, bytes = 0x1409000000000000} } Domain: ***wwwdotattdotcom was written here the validator of this reply did not allow it*** User Approval: unspecified Site/Fmwk Approval: approved Flags: Last Checked: 2026-01-28 13:33:27 +0000 Next Check: 2026-02-02 13:25:30 +0000
My local experience is setup correctly for url: https://www.att.com/numverify/appclip/, same as the link I am trying to press from notes app, otherwise it would not have worked for QR code scanning.
You wrote "Make sure your Local Experience is configured such that the URL used on the HTML page matches the URL" I do not have an HTML page set up yet with the <meta app-clip-bundle-id > element. that was my question, must I have an HTML page to make this flow work? and are there other ways?