Markdown

App Store: Create a bundle identifier

For iOS and macOS, the platform offers the bundle identifiers of your Apple team for selection; you create new identifiers in the Apple Developer portal.

On this page

A bundle identifier is the unique identifier of an app at Apple, written in reverse DNS format such as com.example.app. Apple uses it to tie certificates, provisioning profiles, and the store listing to your app. In the platform you pick the bundle identifier from a list when creating or editing an app; the list comes from the identifiers of the App Store account you selected for the app. You therefore need a stored App Store account and access to Certificates, Identifiers & Profiles in the Developer portal.

Create the identifier in the Developer portal

  1. Open developer.apple.com/account and go to Certificates, Identifiers & ProfilesIdentifiers.
  2. Click +, choose App IDs, and continue.
  3. Select the type App and enter a description that lets the team recognize the identifier later.
  4. Enter the Bundle ID. If the app is meant for both iOS and macOS, you may need separate identifiers for the two platforms depending on the setup.
  5. Enable the capabilities the app requires and save.

Choose the bundle ID carefully, because it can practically no longer be changed after publication. There should be exactly one stable identifier per app and platform.

Select the identifier in the platform

After saving, the new identifier appears in the platform as soon as you select the matching App Store account on the app. If it is missing from the list, close the dialog and open it again, or briefly switch the account and back so the list reloads. If the list stays completely empty, the API key of the account lacks the permission to read identifiers and apps; adjust the role of the key in App Store Connect in that case.