{"id":10380,"date":"2025-09-22T19:49:21","date_gmt":"2025-09-22T23:49:21","guid":{"rendered":"https:\/\/learndash.com\/support\/?post_type=docs&p=10380"},"modified":"2025-09-23T10:43:24","modified_gmt":"2025-09-23T14:43:24","password":"","slug":"how-to-configure-apple-universal-links-for-your-learndash-app","status":"publish","type":"docs","link":"https:\/\/learndash.com\/support\/kb\/learndash-app\/learndash-app-learndash-app\/how-to-configure-apple-universal-links-for-your-learndash-app\/","title":{"rendered":"How to Configure Apple Universal Links for your Learndash App"},"content":{"rendered":"\n

Introduction<\/strong><\/h2>\n\n\n\n

Apple Universal<\/a> 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.<\/p>\n\n\n\n

Enabling Associated Domains<\/strong><\/h2>\n\n\n\n
    \n
  1. Log in to your Apple Developer account at appleid.apple.com<\/strong>, then open Certificates, Identifiers & Profiles<\/strong>.
    <\/li>\n\n\n\n
  2. Select Identifiers<\/strong>, click your App ID.<\/li>\n<\/ol>\n\n\n
    \n
    \"Screenshot<\/figure><\/div>\n\n\n
      \n
    1. Go to the Capabilities<\/strong> tab.
      <\/li>\n\n\n\n
    2. Check Associated Domains<\/strong> and click Save<\/strong>.
      <\/li>\n<\/ol>\n\n\n\n

      Note:<\/strong> After toggling this capability, you must regenerate your provisioning profiles.<\/p>\n\n\n\n

      Regenerating Provisioning Profiles<\/strong><\/h2>\n\n\n\n
        \n
      1. In WordPress, go to Learndash App > Configure > iOS Settings<\/strong> and find Provisioning Profiles<\/strong>.
        <\/li>\n\n\n\n
      2. Uncheck Automatically generate provisioning profiles<\/strong> and click Save Changes<\/strong>.<\/li>\n<\/ol>\n\n\n
        \n
        \"Screenshot<\/figure><\/div>\n\n\n
          \n
        1. Click the X<\/strong> next to each existing profile to delete it, then click Save Changes<\/strong> again.
          <\/li>\n\n\n\n
        2. Re-enable Automatically generate provisioning profiles<\/strong> and click Save Changes<\/strong> to create fresh profiles.
          <\/li>\n<\/ol>\n\n\n\n

          Activating Universal Links<\/strong><\/h2>\n\n\n\n
            \n
          1. Navigate to Learndash App > Configure > iOS Settings > Universal Links<\/strong>.
            <\/li>\n\n\n\n
          2. Check Enable Universal Links<\/strong>.<\/li>\n<\/ol>\n\n\n
            \n
            \"Screenshot<\/figure><\/div>\n\n\n
              \n
            1. (Optional) In Excluded Links<\/strong>, list any URL patterns you don\u2019t want to open in the app.
              <\/li>\n\n\n\n
            2. Click Save Changes<\/strong>.
              <\/li>\n<\/ol>\n\n\n\n

              Note:<\/strong> You must request a new iOS build whenever you enable or disable Universal Links.<\/p>\n\n\n\n

              Verifying Your Association File<\/strong><\/h2>\n\n\n\n

              Open your browser and visit:<\/p>\n\n\n\n

              \nhttps:\/\/<your-site-url>\/.well-known\/apple-app-site-association\n<\/div><\/figure>\n\n\n\n

              You should see a valid JSON response containing your app identifiers and supported paths.<\/p>\n\n\n\n

              Troubleshooting and FAQs<\/strong><\/h2>\n\n\n\n

              Q: My build fails after enabling Associated Domains, what should I check?<\/strong>
              <\/strong> A: Ensure you deleted and regenerated your provisioning profiles, then rebuild and upload the new IPA.<\/p>\n\n\n\n

              Q: Universal Links aren\u2019t opening the app, why?<\/strong>
              <\/strong> A: Verify your apple-app-site-association file is served over HTTPS without redirects and contains the correct appID and paths arrays.<\/p>\n\n\n\n

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

              Q: I get a 404 when fetching the association file, what\u2019s wrong?<\/strong>
              <\/strong> 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.<\/p>\n\n\n\n

              Q: Will disabling Universal Links break existing deep links?<\/strong>
              <\/strong> 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.<\/p>\n","protected":false},"excerpt":{"rendered":"

              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…<\/p>\n","protected":false},"author":58,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_helpful_status":1,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"doc_category":[284],"doc_tag":[],"knowledge_base":[283],"class_list":["post-10380","docs","type-docs","status-publish","hentry","doc_category-learndash-app-learndash-app","knowledge_base-learndash-app"],"year_month":"2026-04","word_count":389,"total_views":"510","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Stephanie Liy","author_link":"https:\/\/learndash.com\/support\/author\/stephaniei\/"},"doc_category_info":[{"term_name":"Getting Started with the LearnDash App","term_url":"https:\/\/learndash.com\/support\/kb\/learndash-app\/learndash-app-learndash-app\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":284,"label":"Getting Started with the LearnDash App"}],"knowledge_base":[{"value":283,"label":"LearnDash App"}]},"featured_image_src_large":false,"comment_info":0,"knowledge_base_info":[{"term_name":"LearnDash App","term_url":"https:\/\/learndash.com\/support\/kb\/learndash-app\/","term_slug":"learndash-app"}],"knowledge_base_slug":["learndash-app"],"_links":{"self":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10380","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/users\/58"}],"replies":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/comments?post=10380"}],"version-history":[{"count":2,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10380\/revisions"}],"predecessor-version":[{"id":10772,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10380\/revisions\/10772"}],"wp:attachment":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/media?parent=10380"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_category?post=10380"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_tag?post=10380"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/knowledge_base?post=10380"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}