> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How To Release a Build on the App Store

To release a build on the App Store, you'll need to:

1. Upload the build.
2. Submit the build for review on App Store Connect.
3. Release the build after it's approved.

<Steps>
  <Step title="Upload the Build">
    This guide will show you how to upload a build using Transporter:

    1. [Download Transporter](https://apps.apple.com/us/app/transporter/id1450874784?mt=12) from the Apple Store. You can also use Xcode/altool, but Transporter is easiest.
    2. Open the Transporter app and log in. If you have access to multiple developer accounts, select the developer account that has the app you want to upload a release for.
    3. Select **+**.
           <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/addbuild1.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=3dfcad129a98c4b083c3bc2ed96b1b4b" alt="Add a build" width="724" height="264" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/addbuild1.svg" />
    4. Select the .ipa file you want to upload and select **Open**.
    5. Select **DELIVER**.
    6. If you receive a prompt to install Xcode, select **Continue Without Xcode**.

    Once the build is delivered, you'll see within Transporter that the app is processing.

    <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/appprocessing.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=61fe06b0a76d3caf9569b2c96043dc20" alt="App processing" width="724" height="136" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/appprocessing.svg" />

    You'll also see a desktop confirmation.

    <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/desktopconfirmation.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=1686568066b0d20146a9fa9ccf94d69e" alt="Desktop confirmation" width="724" height="180" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/desktopconfirmation.svg" />
  </Step>

  <Step title="Submit the Build">
    Once a build has been uploaded through Transporter, you can submit that build for App Store review:

    1. Log in to [App Store Connect](https://appstoreconnect.apple.com) with the same account you used in Transporter.
    2. Select **Apps**.
           <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/apps.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=58ce0a1f6ed5bb5b68bd90aafc119bf0" alt="Apps" width="724" height="356" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/apps.svg" />
    3. If you have access to multiple clients, select the relevant one.
    4. Select **+** to begin staging a new release.

           <Note>
             **NOTE**

             If needed, you can select **Save** at any time and return later.
           </Note>

           <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/stagenewrelease1.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=522291d9a914ad4add34ca1ba84f57bf" alt="Stage new release" width="350" height="324" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/stagenewrelease1.svg" />
    5. Enter the branch number provided by MX. If you see **\[your\_version\_number] Prepare for Submission**, as shown in the following image, you've entered the correct branch number.
           <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/prepforsubmission.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=5dbeca0b2ceb8e2bfbdf8b123aadc5e9" alt="Prepare for Submission" width="553" height="240" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/prepforsubmission.svg" />
    6. Select the **TestFlight** tab to see the status of your build upload from Transporter.
           <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/testflight.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=e23cfc8313b20c99187be5555adf894f" alt="Testflight tab" width="824" height="376" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/testflight.svg" />
    7. Once the upload is complete, its status will change to **Processing**.
           <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/processing.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=446fee4851e3a6a317f0e0c76027ab0b" alt="Status change after upload is complete" width="773" height="318" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/processing.svg" />
    8. If you see **Missing Compliance** in the status, select **Manage**.
           <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/missingcompliance.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=e6a9b8ca6309434124f0eeae3b7efb1a" alt="Missing compliance in status" width="724" height="291" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/missingcompliance.svg" />
    9. If you see the **Export Compliance Information** screen, select the following option: "Standard encryption algorithms instead of, or in addition to, using or accessing the encryption within Apple's operating system."
    10. The next and final question is regarding availability in France. Select **No**, then select **Done**.
    11. Return to the **Distribution** tab.
            <img src="https://mintcdn.com/mx-7a01b258/2CWOnx7baIckmnqs/images/experience/legacy-mobile/how-to-release-a-new-build/distribution.svg?fit=max&auto=format&n=2CWOnx7baIckmnqs&q=85&s=62001d08441fbfc5bc6fb5b4632df82d" alt="Distribution tab" width="724" height="333" data-path="images/experience/legacy-mobile/how-to-release-a-new-build/distribution.svg" />
    12. Within the **Distribution** tab, review the following fields. We'll cover each field and share any recommendations.
        | Field                            | Notes                                                                                                                                                                            |
        | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
        | **iOS Previews and Screenshots** | Existing app listings can carry over screenshots from previous releases. New app listings will require MX to coordinate internally with our design team to generate screenshots. |
        | **Promotional Text**             | This is optional, but typically left blank.                                                                                                                                      |
        | **Description**                  | This is typically created for the initial listing and never needs an update.                                                                                                     |
        | **What's New in This Version**   | The default for this field is usually "Minor enhancements and bug fixes."                                                                                                        |
        | **Keywords**                     | This is optional and for store search optimization. By default, this persists across releases.                                                                                   |
        | **Support URL**                  | This is optional. By default, this persists across releases.                                                                                                                     |
        | **Marketing URL**                | This is optional. By default, this persists across releases.                                                                                                                     |
        | **Version**                      | This is filled in automatically after entering the branch number.                                                                                                                |
        | **Copyright**                    | This is optional. By default, this persists across releases.                                                                                                                     |
        | **Routing App Coverage File**    | This is optional, but typically left blank.                                                                                                                                      |
        | **App Clip**                     | You can skip this.                                                                                                                                                               |
        | **iMessage App**                 | You can skip this.                                                                                                                                                               |
        | **Apple Watch**                  | You can skip this.                                                                                                                                                               |
    13. When you get to the **Build** section, select **+** (or you can select **Add Build**) to add the build that was uploaded via Transporter. Select the radio button left of the build's icon, then select **Done**. After selecting **Done**, leave the **Game Center** checkbox unchecked.
    14. In the **App Review Information** section, ensure **Sign-in required** is checked and that the username and password are both valid. You can include more details in **Notes**. Ensure the details in **Contact Information** are up to date.
    15. In the **Version Release** and **Phased Release for Automatic Updates** sections, select the options that match your needs. **Manually release this version** and **Release update to all users immediately** are good defaults.
    16. In the **Reset iOS Summary Rating** section, you can typically use **Keep existing rating**.
    17. Once all of this is reviewed, select **Add for Review**, then select **Submit to App Review**.

    An alert will appear saying your submission has been submitted for review.

    Confirmation that the app has passed the App Store's vetting will be delivered to the email associated with your App Manager privileges. You can also return to the page to check for updates.
  </Step>

  <Step title="Release the Build on the App Store">
    You'll know the build is store approved and ready to be released when you've received a confirmation email or have confirmed the build is ready to release in App Store Connect.

    If you receive an email from Apple Support about invalid purpose string values, you can disregard it.

    After you've confirmed the build is release-ready, you can release it by following these steps on [App Store Connect](https://appstoreconnect.apple.com):

    1. If you need to edit the time the build releases, select **Edit** next to **Version Release** to schedule the build to release immediately or at a later time.
    2. Select **Release This Version**. A confirmation window will appear including a list of countries where the app will be available for download. If you need to change the list of countries, you can edit this in **Pricing and Availability**.
    3. Again, select **Release This Version**. You'll have three confirmations that the build is available:
       * You'll see **Ready for Sale** in the upper right next to your version number.
       * You'll get an email from the App Store confirming availability.
       * You'll be able to download the updated version from the App Store, typically within 1 to 30 minutes.
  </Step>
</Steps>
