Troubleshooting

Something not working? Start with the page that matches your symptom. Each entry follows the same format: what you're seeing, why it happens, and how to fix it.

In this section

• Deep link doesn't open the app — links open the browser instead of your app: Universal Links, Android App Links, fingerprints, and the native config behind Flutter and React Native.
• Deferred deep linking — the link was clicked before the app was installed and the payload never arrives, usually because of how the flow was tested.
• SDK configuration issues — the SDK doesn't initialize, links come back nil/null, or you're mixing up test and production environments.
• FAQ — quick answers on platforms, custom domains, MAUs, self-hosting, Expo, and more.