---
title: "How to Install iOS Test Builds"
source: "https://docs.nexcess.com/software/learndash/install-ios-test-builds/"
description: "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 w…"
vertical: "Software"
area: "LearnDash"
date: "2025-09-23"
last_modified: "2026-07-02"
---

# How to Install iOS Test Builds

## **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 a Test App, your device must be registered.

1. Go to **WordPress Admin > Learndash App > Configure > iOS Devices
2. Click **Add New Device**

![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXf54qjifADBx25lHnEnFg9GP_uZlWDenoyyw9pkQa1N2JvdyfV3zjctXyQtM5l5dlkJHs9iN4uKlk46vCNJJcFXdtpnMViKzxCDZnbnssG05ehQyLvFy0ysKXOVt6bjY_65eiJVOg.png)3. Enter a **Device Name** (e.g., *Newt’s iPhone*)

![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXcp8QJ7zuzYp1IM0s7wvDC5_fCaNUxRuv64Mvd_CT2un9wV4cfqSte3DaRUsmnV6qm6qzpMQDD56YFwqFmW_OE1F0dZAqQYuE7xlFlM78jhPJ-eJEM-DSpDZyglzYtoZTcUZKqquA.png)4. On your iPhone, scan the **QR code** to install the provisioning profile

![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXca8_dMcyoCd4Nsz2N-4kFV5mC7Tb_dDx84dz6O_dBDiW0yfobVsWMqt_31kNNVq7PUkmJYVYcTbNgghG8e-x1oExzyNfoVZ9rm2UrUyYuD8MxWBHfXuP1bBgzs2mOlpdTffPxVPA.png)5. Click **Refresh** to confirm your device appears in the list

**Note:** Apple allows registration of up to 100 devices. Each new device requires a new Test Build.

## **Requesting an iOS Test Build**

1. Go to **Learndash App > Builds > Request Build**

![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXfkZlhui3ZLxlHH9RTyJLcb9Ed4agwaTa5F4EMtNLAM-NTPjABWj52JkWy6ZE4Oe34letrTkZ5AnzgVBPoK-_Vgs7Ki6Bjp_IlUmx461OOc7MaJtLa176VZn6o1h7uaAkzTAZQ2ag.png)2. Select **iOS** under **Platforms
3. Choose **Test App** for **Build Type**

![](https://docs.nexcess.com/wp-content/uploads/2026/07/AD_4nXcxpEIoqe9OMNqMWgFknvZwPklav3gwJzEZ5cZG8ywIjLDy8OH7R0UkgWMqZjCPkJiZiEj6z-4LmQQpfrjBAfomBYdeiSr2OxACDPKwyfhfxc9v7A0yLg5ZXjFiaEf79NNGgCXVFg.png)4. Click **Next**, review your configuration, then click **Send Build Request

**Builds typically complete within 15–60 minutes**. Click **Recheck Status Now** to refresh build progress.

## **Checking Build Status**

To review your builds, visit **Learndash App > Builds**. Each build card includes:

- Build Number
- Build Status (e.g., Queued, In Progress, Completed)
- Platform (iOS or Android)
- Build Type (Test or Release)
- Date and Time
- **Install Test App** button (when ready)

## **Installing the Test App**

Once the build status is **Completed**:

1. Click **Install Test App** on the iOS build card
2. Scan the **QR code** with your iPhone camera
3. On the download page, tap **Download Application**, then **Install
4. Open the app and test your configurations

**Note:** Android Test Apps do not require UDID registration. Just scan and install.

## **Switching Sites & Testing Custom Code**

Within the Test App:

- Use the **site switcher** to access any connected WordPress site
- To test custom GitHub code, push your changes and **request a new Test Build

## **Troubleshooting and FAQs**

**Q: My iPhone didn’t install the Test App.  
 **A:** Make sure the provisioning profile is installed via **Settings > General > Device Management**, and your UDID is listed under **iOS Devices**.

**Q: The QR code shows an “Expired” message.  
 **A:** Request a new build and click **Recheck Status Now** to generate a fresh QR code.

**Q: My UDID doesn’t appear after scanning.  
 **A:** Tap **Refresh** in **iOS Devices**. Ensure the profile installation was successful on your iPhone.

**Q: Can I share the QR code with others?  
 **A:** Yes, but only devices registered under **iOS Devices** can install the Test App.

**Q: Can I install the app without scanning the QR code?  
 **A:** The QR code is the preferred method. Alternatively, open the installation link directly on Safari using the same device.