Upload to TestFlight. How to Add Builds of Your iOS Apps?

Upload to TestFlight. How to Add Builds of Your iOS Apps?

In the process of software development, we implement features and test them at the same time.

The testing stage is mostly about checking if the system runs correctly and detecting errors. This task belongs to QA testers, but they need someone to deliver software to them. This is the software developers’ job. It’s up to them to choose the best method that enables it. For example, with some help from TestFlight.

Learn how to use this platform and upload your iOS app to TestFlight. It will help you manage this process and even automate it in the future.

App testing then vs now

It used to take much effort to make iOS app testing possible.

The software developers needed the device’s UDID code to register it on the Apple account. Next, they were generating a provisioning profile (ad hoc type) that supplies the app with digital signs. Otherwise, they wouldn’t be allowed to use that device for tests. Later, they were adding a profile to the app and then, passed it over to testers via external platforms (for example, AppCenter). In the end, they had to send a generated file. Then testers were receiving a notification about a new build.

Unfortunately, every new iOS device had to be registered and developers needed to generate new profiles. It was very time-consuming.

It’s much easier today, with TestFlight. You don’t have to worry about registering devices, a small number of testers, or problems with raising issues. The control over the beta tests is much bigger.

Registration in the iOS Developer Program

There are many software distribution methods. From the export of the app on testing devices to sending it to your App Store Connect account. You can also use TestFlight to share the iOS, tvOS, and watchOS builds among testers and to collect feedback.

For that purpose, you have to join the Apple Developer Program.

The first step is to register yourself as an Apple developer. It’s free and gives you access to loads of information. However, it doesn’t allow you to send your mobile apps to the App Store. To change that, you need to pay 99 USD.

In the past, there were three programs: iOS, OS X, and Safari. Now, there’s just one and the same annual fee (99 USD) covers all of them.

Creating the Apple Developer account

If you don’t have your Apple Developer account yet, go to the program’s official website. In the upper right corner, tap Account. On the next page, you decide whether you want to create a new Apple ID or use the existing one. If you like, you can save some time and use the Apple ID that you already use to shop at iTunes Connect.

When creating a new Apple ID, you need to:

  • Enter your email, password, and security data
  • Answer the security questions
  • For the first log-in, enter the code sent to your email address
  • Accept the legal regulations

Great, now you’re officially an Apple Developer! You have access to libraries and tools, but you still have to join the paid program to send the app to the store. 

Joining the Apple Developer Program

Click Join the Apple Developer Program on the bottom part of the website. Then, choose Enroll.

Enroll button on Apple Developer Program

Apple Developer website

On the next page, you can register yourself as a physical person or a company. In the latter case, the process gets a bit more complicated, because you need to file documents that confirm your engagement in a company.

There are two main benefits of registering as a company:

  • You can invite others to your Apple Developer account. It’s a perfect solution for developers who work together on the same project.
  • A Salesman field on the App Store will display the name of the company instead of your own name and surname.

To move on, choose Physical person / Exclusive owner and click Continue. Then accept the legal agreement.

If you haven’t added any payment data before, enter the billing/company information to verify your identity. Apple is going to try to confirm this information  at your credit card provider, so make sure the data is correct.

Below, you can select the option that enables automatic renewal of your membership in the program, so you won’t have to remember about the subscription. There’s also no risk that your apps will become unavailable (they get deleted from the store when the account is inactive).

Select the agreement if you want your membership to be automatically renewed, and then click Purchase.

Apple Developer Program Enrollment

Apple Developer Program enrollment form

After sending the form and paying the fee, you need to wait for Apple to process your order.

And that’s it! You’ve managed to join the Apple Developer Program.

Signing the code: profiles and certificates

Create a code signing certificate and a proper provisioning profile.

Code signing certificates make it possible to link iOS apps with Apple Developer’s account.

Provisioning profiles are delivered with the iOS apps, so they can be installed on users’ devices.

The developer’s provisioning profile and the certificate that are already in use are dedicated to particular devices. Do you want to share your app among the beta testers or users via the App Store? If that’s so, you need a separate sharing profile and distribution certificate.

Signing the code

The first option is to turn automatic signing on. It allows Xcode to create and manage the certificates, and profiles. It will also take care of the registration of the new devices for you.

  1. Add your Developer account to Xcode. From the upper menu choose Xcode, and then Preferences.
  2. Go to Accounts. In the bottom left corner, click the plus symbol and then choose Apple ID.
  3. Enter the Apple ID and password used in the program, and then click Next.
  4. Turn the automatic signing on. In Xcode, select the goal and go to the General tab.
  5. In the Signing section, click the field called Automatically manage signing, and then select your team.
  6. If you will connect a new device to your Mac, Xcode will automatically detect it and register it in the provisioning profile of your team. It will enable running the apps on this device.

The second option is to manually sign the app. It requires you to create the proper certificates yourself, as well as the profiles and lists of devices. Then you have to add them to the app on your own.

Upload to TestFlight

First, you need to create a new app on App Store Connect.

It’s a set of online tools that enable, for example, previewing the sales and analytics reports. They also allow you to invite users to beta testing with the TestFlight app.

How to add the app to App Store Connect?

Open the App Store Connect website and choose My Apps.

Next, click + and New App.

In the new window, fill out the necessary data:

  1. Platforms – you need to choose at least one platform for your product. The iPadOS and watchOS apps are considered a part of the iOS platform.
  2. Name – the name of your app that will show up in the App Store. It cannot be longer than 30 characters.
  3. Primary Language – in the case of all users for whom you don’t offer localized info about the product, the App Store will automatically display the data in your primary language.
  4. Bundle ID – this ID must be in accordance with the one you use in Xcode. You cannot change it after sending the first build.
  5. SKU – a unique ID of your app that is not visible in the App Store.
  6. User Access – you can limit the number of users who see this app in App Store Connect. If you choose full access, all users will receive it – no matter what role they have. Remember that such users as Admin, Finance, and Reports cannot have limited access.

Finally, click Create.

Sending the compilation to App Store Connect

I assume that your iOS is configured for a provisioning profile. It has its app ID, and you have already filled out the data on your App Store Connect account.

In this case, after building the app all that is left to do is to send it to App Store Connect.  The process of sending the builds may seem complicated but as soon as you learn it, it won’t be a problem anymore.

You need to take two simple steps:

  1. Archive your app.
  2. Send the archive to App Store Connect.

Step 1. Archiving the app

The archive is a build of your app. It includes the information about the debugging that Xcode keeps in an app bundle. It allows the app to be compiled and you receive the IPA file that is sent to App Store Connect.

What now? Open the project in Xcode and choose Any iOS Device (arm64) in the device selection window.

Next, select the archiving options in the menu Product -> Archive.

After the successful archiving, the Organizer window will open up with your iOS app. Next, click Distribute app.

Then you’ll be able to choose a distribution method. You’re interested in the first option: App Store Connect. It is used to distribute the app to TestFlight and App Store. Click Next.

Now, you should see a selection of the target place. It is where you click Upload. The Export option enables you to export the signed archive. You can use it with other tools. Click Next.

In this view, you select the distribution options. It’s recommended to choose all of them, because they may all come in handy.

  • Strip Swift Symbols allows you to reduce the size of the app.
  • App’s symbols enable receiving the performance and issue reports.
  • Manage versions and build numbers – this option automatically sets the proper parameters. You don’t have to enter the version number or the build number in the Xcode app.
  • App’s bit code is a file that Apple can use to recompile the app for future changes in the iOS system.

Next, you’ll be asked to choose the certificate and provisioning profile. When Xcode completes preparing the archive for distribution, you should see a list with a summary of the information about the app you want to upload. All it takes is to click Send.

If you haven’t created a proper app in the App Store Connect or when the bundle IDs don’t match, the error message may show up. But when everything goes according to plan, after sending the app to the App Store Connect, you will receive a success notification.

From now on, your app will be processed and it may take some time before it will appear on TestFlight. Usually, it takes from several minutes to an hour but it can be longer.

After processing the compilation, you will receive an email and the beta version of your app will become available on App Store Connect.

Step 2. Sending the iOS app to App Store Connect

In App Store Connect, you manage iOS, iPadOS, macOS, and tvOS apps. Here you create a page of your product, choose the subscription fees, add screenshots, etc. Although now, the most important thing is the possibility to test the software. To do that, you need to enter My Apps on the dashboard and choose the app.

On the next window, tap the TestFlight option.

Then, you should see all the compilations that have been sent.

Sending the mobile app to TestFlight. Why should you know this process?

Software developers must know the distribution process because they are responsible for sending the version of the app to tests. Regularly delivered compilations mean regular tests. It directly impacts better product quality.

It’s equally important to be familiar with the TestFlight platform. It’s good to know how to add external and internal testers, what types of beta tests you can run, or how to send reports and feedback.


Over the years, the iOS app distribution system has been changing. New external solutions were created that required additional implementations, creating new accounts, and continuously adding new testing devices. The entire process was becoming mundane and less effective.

Today, with TestFlight this job is easier and developers have more time to build the apps.


Wojtek Byczkowski

iOS Developer

Learn more

Project estimation

Let us know what product you want to build and how we can help you.

Why choose us?

Logo Mobile Trends Awards

Mobile Trends Awards 2021

Winning app in

Nagroda Legalnych Bukmacherów

Legal Bookmakers Award 2019

Best Mobile App

Mobile Trends Awards logo

Mobile Trends Awards 2023



client reviews

Clutch logo