--- title: Changing the bundle identifier framework: xcode role: article role_heading: Article path: xcode/changing-the-bundle-identifier --- # Changing the bundle identifier Modify your app’s bundle identifier and update it anywhere it appears. ## Overview Overview If you want to change your app’s bundle ID before you upload a build to App Store Connect, you need to change it in multiple locations. It’s particularly important that you update the bundle ID in all the locations below if your app uses certain capabilities that depend on the bundle ID. The bundle ID is an information property list key that uniquely identifies your app throughout the system. Some capabilities use information property list or entitlement keys in your project that contain the main bundle ID. If you refer to a bundle ID in your code, replace it with the bundle() macro that returns the bundle for the calling code. note: If you use Xcode Cloud, commit your project changes to your remote repository before creating a workflow. Change the main bundle ID First, change the bundle ID in your Xcode project: In the Project navigator, select the project. In the project editor on the right, select the target. Click the Signing & Capabilities tab and if necessary, expand Signing. In the Bundle Identifier text field, enter your new bundle ID and press Return. Xcode changes the underlying CFBundleIdentifier information property list key that appears in the app bundle. Update companion target bundle IDs Change any target bundle IDs that are derived from the main bundle ID, such as, bundle IDs for watchOS, app extension, and app clip targets. In the project editor, select each target in the sidebar and update its bundle ID in the Bundle Identifier field on the Signing & Capabilities pane on the right. For watchOS targets, Xcode updates the underlying WKCompanionAppBundleIdentifier and WKAppBundleIdentifier information property list keys. Change keys that depend on the main bundle ID Update any other information property list and entitlement keys that contain the main bundle ID. For example, if you use App Clips, change the associated com.apple.developer.associated-appclip-app-identifiers and Parent Application Identifiers Entitlement keys. If you have an app extension, be sure to change the com.apple.developer.app-migration.data-container-access key too. Update the bundle ID in App Store Connect important: If you previously uploaded a build to App Store Connect, you can’t change the bundle ID. Create a new app record with the bundle ID instead of updating the existing app record. For more information, see Add a new app. If you plan to distribute your app through the App Store and you’ve created an app record, but haven’t uploaded a build yet, then you can still change the bundle ID in your app record to match your Xcode project. After you change the bundle ID in your Xcode project, to update the bundle ID in your app record in App Store Connect: Build and run your app on a device to register the new bundle ID and update the provisioning profile. In App Store Connect, select Apps and then select your app. In the Distribution pane, select App Information under General in the sidebar. Choose the new identifier from the Bundle ID pop-up menu under General Information on the right, and click Save. For more information, see View and edit app information. Update any other settings in App Store Connect that use the bundle ID, such as in-app purchase settings. Re-request any special entitlements from Apple that require approval. Deleting an existing app record doesn’t make its bundle ID available. note: If you use any third-party services that depend on your app’s bundle ID, notify them to update your app’s bundle ID too. Update manual provisioning profiles If you use manual provisioning, update the App ID in those provisioning files to match the bundle ID in your project. For more information, see Edit, download, or delete provisioning profiles in Developer Account Help. After you update your provisioning profile in your developer account, you can download it from Xcode > Settings > Accounts, using the Download Manual Profiles button when you select your account. If you toggle the “Automatically manage signing” checkbox in the Signing & Capabilities pane, Xcode updates your provisioning profiles for you. ## See Also ### Setup and maintenance - [Making dependencies available to Xcode Cloud](xcode/making-dependencies-available-to-xcode-cloud.md) - [Configuring Xcode Cloud for your team](xcode/configuring-xcode-cloud-for-your-team.md) - [Sharing macOS and Xcode versions across Xcode Cloud workflows](xcode/sharing-custom-aliases-across-xcode-cloud-workflows.md) - [Sharing environment variables across Xcode Cloud workflows](xcode/sharing-environment-variables-across-xcode-cloud-workflows.md) - [Building Swift packages and Swift Playgrounds app projects with Xcode Cloud](xcode/building-swift-packages-or-swift-playground-app-projects-with-xcode-cloud.md) - [Setting the next build number for Xcode Cloud builds](xcode/setting-the-next-build-number-for-xcode-cloud-builds.md) - [Including notes for testers with a beta release of your app](xcode/including-notes-for-testers-with-a-beta-release-of-your-app.md) - [Removing your project from Xcode Cloud](xcode/removing-your-project-from-xcode-cloud.md)