iOS Universal Link opens app and then opens browser (Flutter + Universal Links) — only when using paths/params

Hi everyone, I’ve been stuck on an issue with iOS Universal Links for about a week and could really use some help.

The problem When tapping a Universal Link on iOS, my Flutter app opens correctly (desired behavior) — but immediately afterward, Safari opens the same link in the browser. So both the app and the browser open. This only happens on iOS. On Android everything works as expected.

What works If the link is simply the domain, like: https://mydomain.com

…then the app opens without triggering the browser afterward. This is the correct behavior.

What doesn’t work If the link includes a path or parameters, like: https://mydomain.com/path https://mydomain.com/path?param=value

…then the app opens, and then the browser opens immediately after.

What I’ve tried

Verified my AASA file using Branch’s validator: https://branch.io/resources/aasa-validator/

→ The AASA file is valid.

Universal Links do open the correct screen inside the app — the issue is the unwanted second step (Safari opening).

Behavior is consistent across different iOS devices.

Extra details

Using Flutter.

Universal Links set up with the standard configuration (associatedDomains, AASA hosted at /.well-known/apple-app-site-association, etc.).

Question Has anyone encountered this issue where Universal Links with paths/params open the app and then open Safari? What could cause iOS to trigger the browser fallback even when the AASA file is valid and the app handles the link correctly?

Any insights, debugging tips, or known edge cases would be incredibly appreciated!

Thank you for your post. I am unfamiliar with Flutter. Have you created a simple, focused project in Xcode to verify the AASA file? Do you have a link to the public AASA file?

Have you reviewed the troubleshooting guide for Universal Links, as it was specifically designed for Xcode and may provide assistance? Have you reached out to the third-party developers who developed Flutter for their support?

You should check with the support resources provided by the 3rd party to get assistance with their software.

The troubleshooting guide can be found here if you are interested. TN3155: Debugging universal links | Apple Developer Documentation

Albert Pascual
  Worldwide Developer Relations.

iOS Universal Link opens app and then opens browser (Flutter + Universal Links) — only when using paths/params
 
 
Q