---
title: "How to Configure Apple Universal Links for your Learndash App"
source: "https://docs.nexcess.com/software/learndash/configure-apple-universal-links/"
description: "Introduction Apple Universal Links let your website URLs open directly in the Learndash App on iOS, eliminating Safari redirects and creating a seamless experie…"
vertical: "Software"
area: "LearnDash"
date: "2025-09-22"
last_modified: "2026-07-02"
---

# How to Configure Apple Universal Links for your Learndash App

## **Introduction**

[Apple Universal](https://developer.apple.com/ios/universal-links/) 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](https://docs.nexcess.com/wp-content/uploads/2026/06/How-to-Configure-Apple-Universal-Links-for-your-Learndash-App-_-1.png)3. Go to the **Capabilities** tab.
4. 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](https://docs.nexcess.com/wp-content/uploads/2026/06/How-to-Configure-Apple-Universal-Links-for-your-Learndash-App-_-3.png)3. Click the **X** next to each existing profile to delete it, then click **Save Changes** again.
4. 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](https://docs.nexcess.com/wp-content/uploads/2026/06/How-to-Configure-Apple-Universal-Links-for-your-Learndash-App-_-4.png)3. (Optional) In **Excluded Links**, list any URL patterns you don’t want to open in the app.
4. 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.