View Categories

How to Configure Apple Universal Links for your Learndash App

Introduction #

Apple Universal Links let your website URLs open directly in the Learndash App on iOS, eliminating Safari redirects and creating a seamless experience. This guide walks you through enabling Associated Domains in your Apple Developer account, regenerating provisioning profiles, configuring Universal Links in the Learndash App plugin, and verifying your setup.

Enabling Associated Domains #

  1. Log in to your Apple Developer account at appleid.apple.com, then open Certificates, Identifiers & Profiles.
  2. Select Identifiers, click your App ID.
Screenshot of Certificates, Identifiers, and Profiles
  1. Go to the Capabilities tab.
  2. Check Associated Domains and click Save.

Note: After toggling this capability, you must regenerate your provisioning profiles.

Regenerating Provisioning Profiles #

  1. In WordPress, go to Learndash App > Configure > iOS Settings and find Provisioning Profiles.
  2. Uncheck Automatically generate provisioning profiles and click Save Changes.
Screenshot of provisioning profiles
  1. Click the X next to each existing profile to delete it, then click Save Changes again.
  2. Re-enable Automatically generate provisioning profiles and click Save Changes to create fresh profiles.

Activating Universal Links #

  1. Navigate to Learndash App > Configure > iOS Settings > Universal Links.
  2. Check Enable Universal Links.
Screenshot of Universal Links
  1. (Optional) In Excluded Links, list any URL patterns you don’t want to open in the app.
  2. Click Save Changes.

Note: You must request a new iOS build whenever you enable or disable Universal Links.

Verifying Your Association File #

Open your browser and visit:

https://<your-site-url>/.well-known/apple-app-site-association

You should see a valid JSON response containing your app identifiers and supported paths.

Troubleshooting and FAQs #

Q: My build fails after enabling Associated Domains, what should I check?
 A: Ensure you deleted and regenerated your provisioning profiles, 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 the correct appID and paths arrays.

Q: How do I exclude certain URLs from Universal Links?
 A: Add them to the Excluded Paths field under Universal Links in your Learndash App settings, then save and rebuild.

Q: I get a 404 when fetching the association file, what’s wrong?
 A: Make sure your server allows access to /.well-known/ and that the apple-app-site-association file resides at /.well-known/apple-app-site-association.

Q: Will disabling Universal Links break existing deep links?
 A: Yes, URLs will revert to opening in Safari. Re-enable Universal Links in settings and request a new build to restore in-app behavior.

Updated on September 23, 2025