How to Configure Apple Universal Links

Introduction

Apple Universal Links allow links to your website to open directly in the BuddyBoss App on iOS devices, creating a seamless user experience. This guide walks you through enabling Associated Domains in your Apple Developer account, regenerating provisioning profiles, configuring Universal Links in the BuddyBoss App, and verifying the setup.

Note: Enabling Universal Links requires Associated Domains to be enabled under capabilities for your iOS App.

Enable Associated Domains in Apple Developer

1. Log in to your Apple Developer Account using the Apple ID you created your Apple Developer account with.
2. Click on Certificates, Identifiers & Profiles.
3. Click on the Identifiers tab and then click your App ID.

App Identifiers

4. In the Capabilities tab, mark the checkbox for Associated Domains and then click the Save button.

Enabling Associated Domains capabilities for your app

Note: After enabling Associated Domains capabilities, you MUST regenerate the Provisioning Profiles for your iOS app.

Regenerating Provisioning Profile

To delete the current Provisioning Profile and build a new one:

1. Go to BuddyBoss App > Configure > iOS Settings and scroll down to Provisioning Profiles.
2. Untick the Generate Profiles checkbox and click the Save Changes button.
3. Now, scroll back to Provisioning Profiles and you will now see an X to delete the Provisioning Profiles.
4. Click the X to delete the Provisioning Profiles and then click the Save Changes button.

Regenerating provisioning profile

5. Finally, go back to BuddyBoss App > Configure > iOS Settings > Provisioning Profiles > Generate Profiles and re-tick the Automatically generate provisioning profiles option.
6. Click the Save Changes button.

Enabling Universal Links

To enable the universal links feature:

1. Go to BuddyBoss App > Configure > iOS Settings > Universal Links.
2. Mark the checkbox for Enable Universal Links.
   You will need to generate a new iOS build after enablling/disabling the Universal Links feature.
3. Optionally, enter the URLs or URI fragments you want to exclude from opening in your app.
4. Click the Save Changes button.

Enabling Universal Links for your iOS App

To verify if a valid JSON is served after enabling the Universal Links option, go to the following URL in your browser:

{{your site url}}/.well-known/apple-app-site-association/

For example:

Excluded URLs and URI fragments in the JSON file for iOS

Troubleshooting and FAQs

Q: My build fails after enabling Associated Domains—what should I check?
A: Ensure you regenerated provisioning profiles after toggling the capability, then rebuild and upload the new IPA.

Q: Universal Links aren’t opening the app—why?
A: Verify your apple-app-site-association file is served over HTTPS without redirects and contains correct appID and path entries.

Q: How can I exclude specific paths from Universal Links?
A: List them in the Excluded Paths field under Universal Links in your BuddyBoss App settings, then save and rebuild.

Q: I see 404 when fetching the association file—what’s wrong?
A: Ensure your server allows access to the /.well-known/ directory and that the association file is present at the correct location.

Q: Will disabling Universal Links break deep links?
A: Yes—URLs will revert to opening in Safari. Re-enable Universal Links and rebuild to restore in-app linking.