Set Up Distribution for iOS
Prepare your branded app for distribution on the Apple App Store, either publicly to all users or privately through Apple Business Manager to users within your organization.
Required Editions
| Setup for Mobile Publisher available in: Lightning Experience |
| Setup for Mobile Publisher available in: production only (not sandbox) |
| Available in Lightning Experience in: Enterprise, Performance, and Unlimited Editions |
| User Permissions Needed | |
|---|---|
| To create and modify a Mobile Publisher project: | Manage mySalesforce Apps |
Mobile Publisher needs certain pieces of information from your Apple Developer account to distribute your branded app. To participate in the Mobile Publisher program for iOS apps, you must have an Apple Developer Program account enrolled as an organization. See the Enrolling as an Organization section in What You Need To Enroll.
Before you submit your app, verify that your Apple Developer account has an iOS distribution certificate available. To verify, log in to your Apple Developer account, go to the Certificates, Identifiers & Profiles page, and click + to add a new certificate. If you get an error that there are no iOS distribution certificates available, then you've reached the limit and you must make a certificate available for your Mobile Publisher app. If you don't get an error, you can cancel the new certificate and proceed to submit your app to Mobile Publisher.
For private distribution specifically, Salesforce requires one Distribution Signing Certificate and one push token from your Apple Developer account to distribute and maintain your branded app.
The setup steps for iOS are the same whether you choose public or private distribution, with two exceptions:
- When you choose your distribution type in Mobile Publisher, you select either Public Distribution or Private Distribution.
- For private distribution users: the Update Test User Credentials step is skipped because test user credentials were already entered during the Create a Placeholder App step.
- For private distribution only, you must also add your Apple Business Manager (ABM) account information to Mobile Publisher so that Salesforce can distribute the app to your organization.
Complete the following steps in order, noting which steps apply to your distribution type.
Public Distribution Steps
- Choose Distribution Type
First, we must choose the correct distribution type for your branded app.
- Register Salesforce Bundle ID
Register your Salesforce bundle ID with your Apple developer account.
- Create a Placeholder App with Privacy Questions and Age
Ratings
Create a placeholder app in your App Store Connect account.
- Update Test User Credentials
Update the test user credentials in your App Store Connect account to avoid app rejections.
- Invite Salesforce to Your App Store Connect
Account
To distribute your branded app, grant Salesforce with App Manager access to your App Store Connect.
- Record Your Apple Developer Team Account
Info
Mobile Publisher needs your Apple developer team name and ID to distribute your branded app.
- Enter Your Apple Developer Information into Your Mobile
Publisher Project
After your prep work, return to your Mobile Publisher project and enter your Apple Developer Team Account information.
Private Distribution Steps
- Choose Distribution Type
First, we must choose the correct distribution type for your branded app.
- Register Salesforce Bundle ID
Register your Salesforce bundle ID with your Apple developer account.
- Find Your Apple Deployment Programs Account
Info
Before you can distribute your branded app, add your Apple Development Programs Account credentials to Mobile Publisher.
- Create a Placeholder App with Privacy Questions and Age
Ratings
Create a placeholder app in your App Store Connect account.
- Invite Salesforce to Your App Store Connect
Account
To distribute your branded app, grant Salesforce with App Manager access to your App Store Connect.
- Record Your Apple Developer Team Account
Info
Mobile Publisher needs your Apple developer team name and ID to distribute your branded app.
- Enter Your Apple Developer Information into Your Mobile
Publisher Project
Now that we've done all our prep work, we can go back to your Mobile Publisher project and enter your Apple Developer Team Account information.
- Choose Distribution Type for Your iOS App
Start the distribution process by selecting your distribution type in Mobile Publisher. - Register Salesforce Bundle ID
Register your Salesforce bundle ID with your Apple developer account. - Create a Placeholder App with Privacy Questions and Age Ratings
Create a placeholder app in your App Store Connect account. - Update Test User Credentials for Public Distribution
For public distribution, update the test user credentials in your App Store Connect account to avoid app rejections. For private distribution, this step was completed during the Create a Placeholder App step. - Invite Salesforce to Your App Store Connect Account
Grant Salesforce with App Manager access to your App Store Connect account to distribute your branded app. - Record Your Apple Developer Team Account Info
Mobile Publisher needs your Apple developer team name and ID to distribute your branded app. - Enter Your Apple Developer Information into Your Mobile Publisher Project
After your prep work, return to your Mobile Publisher project and enter your Apple Developer Team Account information. - Unlisted Option for iOS App Distribution
Learn about unlisted app distribution, an alternative to the traditional public and private app distribution options. Unlisted app distribution is sometimes appropriate for apps that were rejected from App Store public distribution.

