How to Change the Name of an iOS App in Xcode

How to Change the Name of an iOS App in Xcode

22 May 2024 Stephan Petzl Leave a comment Tech-Help

If you began your iOS project with a development code name and now wish to update it to a more appropriate title, this guide will help you through the process. Changing the name of your project in Xcode is relatively straightforward, and this article will walk you through the steps to ensure a smooth transition.

Steps to Change the Project Name in Xcode

Method 1: Changing the Product Name

Follow these steps if you want to change the product name, which is the name used during the build process:

  1. Open your project in Xcode.
  2. Go to the Targets section in Xcode.
  3. Select your project’s target (which currently holds the development name).
  4. Navigate to the Build Settings tab.
  5. Search for the Product Name under the Packaging section.
  6. Change the value of the Product Name to your desired project name.

Method 2: Renaming the Project Root

If you are using a newer version of Xcode, you can rename the project root directly:

  1. Click twice, slowly, on the project root in the project navigator. It will become editable.
  2. Rename the project to your desired name.
  3. Press Enter. Xcode will prompt you to automatically change all project-name-related entries. You can deselect any entries you do not wish to change.
  4. Press RENAME. Xcode may also suggest making a snapshot of the project, which is recommended.

Additionally, to ensure consistency, you may want to rename the scheme to match your new project name:

  1. Repeat the steps mentioned above for the scheme.
  2. Press OK to confirm the changes.

Changing the Display Name

If you only need to change the display name that appears below the app icon on the home screen, follow these steps:

  1. Locate the info.plist file in the “Supporting Files” group.
  2. Find the Bundle display name key and change its value to the new name.
  3. Delete the old app from the simulator or any testing device.
  4. Clean and rebuild your app.


Renaming your iOS project in Xcode can be done through various methods, depending on whether you want to change the product name, project root, or display name. Following the steps outlined above will help you make these changes efficiently.

For more detailed information, you can refer to our comprehensive guides:

Streamline Your Mobile Development with Repeato

If you are a mobile developer looking to streamline your testing process, consider using Repeato. Repeato is a no-code test automation tool for iOS and Android that allows you to create, run, and maintain automated tests for your apps quickly and efficiently. Utilizing computer vision and AI, Repeato ensures that you can focus on developing great products while delegating test automation to non-technical colleagues or QA teams. Learn more about how Repeato can enhance your development workflow on our blog.

Like this article? there’s more where that came from!