{"id":10516,"date":"2025-09-22T20:05:20","date_gmt":"2025-09-23T00:05:20","guid":{"rendered":"https:\/\/learndash.com\/support\/?post_type=docs&p=10516"},"modified":"2025-09-23T10:13:22","modified_gmt":"2025-09-23T14:13:22","password":"","slug":"how-to-install-ios-test-builds","status":"publish","type":"docs","link":"https:\/\/learndash.com\/support\/kb\/learndash-app\/app-builds\/how-to-install-ios-test-builds\/","title":{"rendered":"How to Install iOS Test Builds"},"content":{"rendered":"\n

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

Installing iOS Test Builds for your Learndash App is simple with our cloud-based build system, no Xcode or manual compilation required.

This guide walks you through connecting your site, registering iOS test devices, requesting a Test Build, and installing it on your iPhone via QR code.<\/p>\n\n\n\n

Registering iOS Test Devices<\/strong><\/h2>\n\n\n\n

Before you can install a Test App, your device must be registered.<\/p>\n\n\n\n

    \n
  1. Go to WordPress Admin > Learndash App > Configure > iOS Devices<\/strong>
    <\/strong><\/li>\n\n\n\n
  2. Click Add New Device<\/strong><\/li>\n<\/ol>\n\n\n\n
    \"\"\/<\/figure>\n\n\n\n
      \n
    1. Enter a Device Name<\/strong> (e.g., Newt\u2019s iPhone<\/em>)<\/li>\n<\/ol>\n\n\n\n
      \"\"\/<\/figure>\n\n\n\n
        \n
      1. On your iPhone, scan the QR code<\/strong> to install the provisioning profile<\/li>\n<\/ol>\n\n\n\n
        \"\"\/<\/figure>\n\n\n\n
          \n
        1. Click Refresh<\/strong> to confirm your device appears in the list
          <\/li>\n<\/ol>\n\n\n\n

          Note:<\/strong> Apple allows registration of up to 100 devices. Each new device requires a new Test Build.<\/p>\n\n\n\n

          Requesting an iOS Test Build<\/strong><\/h2>\n\n\n\n
            \n
          1. Go to Learndash App > Builds > Request Build<\/strong><\/li>\n<\/ol>\n\n\n\n
            \"\"\/<\/figure>\n\n\n\n
              \n
            1. Select iOS<\/strong> under Platforms<\/strong>
              <\/strong><\/li>\n\n\n\n
            2. Choose Test App<\/strong> for Build Type<\/strong><\/li>\n<\/ol>\n\n\n\n
              \"\"\/<\/figure>\n\n\n\n
                \n
              1. Click Next<\/strong>, review your configuration, then click Send Build Request<\/strong>
                <\/strong><\/li>\n<\/ol>\n\n\n\n

                Builds typically complete within 15\u201360 minutes<\/strong>. Click Recheck Status Now<\/strong> to refresh build progress.<\/p>\n\n\n\n

                Checking Build Status<\/strong><\/h2>\n\n\n\n

                To review your builds, visit Learndash App > Builds<\/strong>. Each build card includes:<\/p>\n\n\n\n

                  \n
                • Build Number
                  <\/li>\n\n\n\n
                • Build Status (e.g., Queued, In Progress, Completed)
                  <\/li>\n\n\n\n
                • Platform (iOS or Android)
                  <\/li>\n\n\n\n
                • Build Type (Test or Release)
                  <\/li>\n\n\n\n
                • Date and Time
                  <\/li>\n\n\n\n
                • Install Test App<\/strong> button (when ready)
                  <\/li>\n<\/ul>\n\n\n\n

                  Installing the Test App<\/strong><\/h2>\n\n\n\n

                  Once the build status is Completed<\/strong>:<\/p>\n\n\n\n

                    \n
                  1. Click Install Test App<\/strong> on the iOS build card
                    <\/li>\n\n\n\n
                  2. Scan the QR code<\/strong> with your iPhone camera
                    <\/li>\n\n\n\n
                  3. On the download page, tap Download Application<\/strong>, then Install<\/strong>
                    <\/strong><\/li>\n\n\n\n
                  4. Open the app and test your configurations
                    <\/li>\n<\/ol>\n\n\n\n

                    Note:<\/strong> Android Test Apps do not require UDID registration. Just scan and install.<\/p>\n\n\n\n

                    Switching Sites & Testing Custom Code<\/strong><\/h2>\n\n\n\n

                    Within the Test App:<\/p>\n\n\n\n

                      \n
                    • Use the site switcher<\/strong> to access any connected WordPress site
                      <\/li>\n\n\n\n
                    • To test custom GitHub code, push your changes and request a new Test Build<\/strong>
                      <\/strong><\/li>\n<\/ul>\n\n\n\n

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

                      Q: My iPhone didn\u2019t install the Test App.<\/strong>
                      <\/strong> A:<\/strong> Make sure the provisioning profile is installed via Settings > General > Device Management<\/strong>, and your UDID is listed under iOS Devices<\/strong>.<\/p>\n\n\n\n

                      Q: The QR code shows an \u201cExpired\u201d message.<\/strong>
                      <\/strong> A:<\/strong> Request a new build and click Recheck Status Now<\/strong> to generate a fresh QR code.<\/p>\n\n\n\n

                      Q: My UDID doesn\u2019t appear after scanning.<\/strong>
                      <\/strong> A:<\/strong> Tap Refresh<\/strong> in iOS Devices<\/strong>. Ensure the profile installation was successful on your iPhone.<\/p>\n\n\n\n

                      Q: Can I share the QR code with others?<\/strong>
                      <\/strong> A:<\/strong> Yes, but only devices registered under iOS Devices<\/strong> can install the Test App.<\/p>\n\n\n\n

                      Q: Can I install the app without scanning the QR code?<\/strong>
                      <\/strong> A:<\/strong> The QR code is the preferred method. Alternatively, open the installation link directly on Safari using the same device.<\/p>\n","protected":false},"excerpt":{"rendered":"

                      Introduction Installing iOS Test Builds for your Learndash App is simple with our cloud-based build system, no Xcode or manual compilation required. This guide walks you through connecting your site, registering iOS test devices, requesting a Test Build, and installing it on your iPhone via QR code. Registering iOS Test Devices Before you can install…<\/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":[289],"doc_tag":[],"knowledge_base":[283],"class_list":["post-10516","docs","type-docs","status-publish","hentry","doc_category-app-builds","knowledge_base-learndash-app"],"year_month":"2026-04","word_count":438,"total_views":"413","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":"App Builds","term_url":"https:\/\/learndash.com\/support\/kb\/learndash-app\/app-builds\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":289,"label":"App Builds"}],"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\/10516","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=10516"}],"version-history":[{"count":1,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10516\/revisions"}],"predecessor-version":[{"id":10517,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/10516\/revisions\/10517"}],"wp:attachment":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/media?parent=10516"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_category?post=10516"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_tag?post=10516"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/knowledge_base?post=10516"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}