How can I change the name of an iOS app in Xcode?

Question

I began an iPhone project the other day with a silly development code name, and now I want to change the name of the project since it's nearly finished. How can I do this?

• Nosredna: I've had to do this a few times. I use a tool called Rename Xcode Project 2.1.
• Jeffrey Berthiaume: There are times when the simple way still doesn't work (or there are echoes of old naming, etc.). I posted an article showing how to fix this by going into the xml of the project files manually here: change the name of an iPhone app
• Frank Schmitt: Here's a free utility that does this and works well in my experience: change the name of an iPhone app
• JJD: @all: Not fully answered. The title of the application window and the pulldown menu of the application stays with the old name. @Frank Schmitt: The "Rename xCode Project" project fails when the plist file was renamed. It awaits the name Info.plist
• Brandon: Note: You can also change it in InfoPlist.strings so that it's localized for different languages.. Somehow no one posted an answer for that :(

Answer 1

1. Go to Targets in Xcode.
2. Build Settings on your project's target (your current development name).
3. Search for Product Name under Packaging. Change its value to what you want your new project name to be.

ProductName

• Simon Woodside: I had to quit XCode and delete my build directory before it would take for me.
• Tony Eichelberger: Also, remember to change this in each of the configurations! (Debug, Release, Ad Hoc, App Store, etc)
• Hamy: For anyone else that is a complete beginner, "Targets" is inside of the "Groups & Files" pane on the left, it has a red and white target sign next to it ;)
• hallski: In Xcode 4 you can simply double click the target name and change it directly in the target list.
• aledustet: @all there is a really good and updated answer for Xcode5 that worked like a charm, and i think it's the correct one check it out here stackoverflow.com/a/20418989/3027848

Answer 2

In new versions of Xcode (Xcode 5 too), to change the name of the project, follow these simple (detailed as possible) steps:

Note: In this example I'll change a hypothetical "Sample" name to a "Test" one.

1. Click twice slowly on the project root in the project navigator and then it becomes editable.

   Enter image description here

2. Rename the project.

   Enter image description here

3. After pressing Enter the assistant will suggest you to automatically change all project-name-related entries and will allow you to de-select some of them, if you want.

   Enter image description here

4. Press 'RENAME' and Xcode will do the rest. In the meanwhile Xcode may ask you about the option of making a snapshot of the project (it is very recommendable to do so).

5. In addition to renaming the project, you may want to rename the scheme so that it matches your new project name.

   Enter image description here

6. Repeat similar steps like 1 and 2, and press OK.

   Enter image description here

   enter image description here

7. That's it.

Another scenario...

The previous explanation was related to changing the project name, but chances are that you only need to change the display name that appears below the app icon in the home screen. These are the steps:

1. In the "Supporting Files" group locate the info.plist (or related) file

2. Locate the "Bundle display name" key and change the value to the new name.

   enter image description here

   enter image description here

3. Delete the "old" app from the simulator or any other testing device.

4. Clean and rebuild your app again.

5. That's it. You will now see the new app name in your home screen.

• marcel salathe: The scheme change didn't go smoothly for me: could only select My Mac after that. Thankfully the problem is easy to fix: stackoverflow.com/questions/8377970/…
• mattsven: Had the same problem as @marcelsalathe, his fix solved the issue. Ideally this should be added to Javier Cadiz's answer.
• Steve Moser: There is a bug with Xcode where the rename function doesn't rename shared internal framework properly. See here for more info: stackoverflow.com/questions/34749687/…
• Ryan: The "Another scenario" worked great! Two notes: 1. I had to add the "Bundle Display Name" in Info.plist as it was not there by default (Xcode 7). 2. If it doesn't appear to work, make sure you're changing the bundle display name in the Info.plist file in the "Supporting Files" folder like Javier said. I wasn't paying close enough attention and changed it in the ProjectName-Info.plist file that is right below the "Supporting Files" folder and wondered why nothing happened.
• SilverWolf: Important note: This won't rename some files and folders! You can use some sed magic to fix this afterward, though.

Answer 3

You change the bundle display name in the info.plist file. It's as simple as that.

Changing the 'bundle display name' (as opposed to 'bundle name') is the only way to include characters like '+' in your applications name. Including special characters in the project name will cause an error when uploading to App Store!

• Jquery Sage: this is better than changing the target name as it avoids conflict and mess-ups in game engines
• j2emanue: i had to change the product name in info plist and also rename the target name. Then I also had to clean build directory (press and hold options key while traversing to xcode Product menu and there will be an option to clean build directory).
• cloudsurfin: This changes the app name displayed under the icon without the hassle of changing the app id and provisioning profiles. Thanks. Accepted answer no longer applies (as I understand it).
• Matthias Schicker: This is by far the superior solution! JUST changes the name under the icon, and not bundle identifiers which mess up provisioning profiles
• Martyn Davis: If 'Bundle display name' is not shown, then simply add it.

Answer 4

In Xcode 4, search for "Product Name" under "Build Settings" tab of the target.

• Gabriel Goncalves: This is a bad answer, if you do that your test project won't run
• Tash Pemhiwa: ...and 118 other people apparently!
• MiMo: This would works great only with one issue, on your user's devices it will create a separate application with the new name instead of renaming the currently installed one they already have. Changing the 'bundle display name' in the project plist is the best way to do it.

Answer 5

1. Select Target

   Target selected in Xcode sidebar.

2. Select Info

   Info tab selected.

3. Insert Bundle Display Name and set App Title

   Dropdown showing Application Category highlighted.

• Aviel Gross: This is the only solution that doesn't mess up with other file names and identifiers, and mostly - doesn't change the Bundle Identifier - which is essential if you already have an app id...

Answer 6

If you want to change the display name only then you can directly change it in the property file (plist) of the app.

You can add a new row with the following key: Bundle display name

Here is an example for this:

Enter image description here

When you use this the app name, which you have given with this key, it will be displayed.

So you can do this simply.

• Ucdemir: Note = The start of "bundle" have to be capatilized... Correct one is : "Bundle display name"

Answer 7

This is how I changed it in Xcode 4:

1. Click on your target file (the first main file of the application).
2. Go to Build Settings.
3. Scroll down you will find a bar called "Packaging".
4. Under Packaging you will see Product Name, and you can change the project name.

• Orion Edwards: This works, but it also changes the deployed app name (any existing installs won't get "upgraded", it will be a second app). Changing the "bundle display name" as per @CodeHunter's answer is nicer

Answer 8

In Xcode 3.2, just select the Project entry in the Groups & Files panel, and select the menu item Project → Rename... It worked for me.

Answer 9

Xcode 7/8? It's in the plist that your target uses:

Enter image description here

Answer 10

For Xcode 11, if you want to change the App Display Name then simply go to plist and simply replace the value of CFBundleDisplayName:

<key>CFBundleDisplayName</key>
<string>Your App Name</string>

• user2078023: What about when we have multiple schemes? Thanks!
• Peter Mortensen: What is "plist"? A file?
• Muhammad Nayab: @PeterMortensen Yes its a file and it has your applications configurations in it
• Green: This will NOT update your splash screen (aka launch screen) with the new app name. In order to update your splash screen, you must make the changes to the app name directly in Xcode.
• Dimitar Nestorov: I only wanted to change how it appears on Home Screen, app switcher, App Library and Settings without modifying the product name, project name, or target name. This did the trick. Thanks!

Answer 11

For Xcode 10.2:

Although this question has many answers but I wanted to explain the whole concept in detail so that everyone can apply this knowledge to further or previous versions of Xcode too.

Every Xcode project consists of one or more targets. According to apple, A target specifies a product to build and contains the instructions for building the product from a set of files in a project or workspace. So every target is a product (app) on its own.

Steps to change the name:

Step 1: Go to the Targets and open the Info tab of the target whose name you want to change.

Step 2: View the Bundle name key under the Custom iOS Target Properties that is set to the default property of $(PRODUCT_NAME).

enter image description here

Step 3: You can either change the Bundle name directly (not recommended) or if you open the Build Settings tab then on searching for Product Name under Setting you will see that Product Name is set to $(TARGET_NAME).

enter image description here

Step 3A: You can change the Product Name or you can also change the Target Name by double clicking on the target.

enter image description here

So changing the Product Name (App Name) or Target Name both will result into similar results. But if you only want to change the App Name and want to keep using the same Target Name then only change the Product Name.

Answer 12

From Xcode 4.2 and onwards, you can use one more option. Just click once on the .proj file name at the top in left navigation pane and it will be available for renaming. Rename it and the whole project will get renamed and not only the target.

Answer 13

The best way I like in Xcode 5 is to change product name in building settings. Search "product name" in "building settings", and change it.

Enter image description here

Answer 14

If you need to change the name of the application as it appears on the iPhone's home screen, you need to do it in the Target configuration, not the project configuration.

1. Expand the Targets group in Xcode, and then single-click the item under that. It should share the name of your project, which is also the default name of the application that gets generated.

2. Press Command + I to bring up the Info window, and then navigate to the Build tag.

3. Set the Configuration drop-down to read All Configurations.

4. Look for a setting called Product Name under the Packaging heading.

5. Change that value to the name you want for your compiled applications and, in the immortal words of Bugs Bunny: Voilà! Do a clean and a build. Your application will take on the new name.

Answer 15

If you want to change the name, that will be displayed on your screen, right under your icon, in Xcode 4, go to Targets → Info → Bundle Display Name and change it to whatever you want.

Answer 16

In Xcode 4, click on project name to start renaming.

• Joe Regan: I saw the setting as "Product Name" not "Project Name" - in any case, the change worked.
• Giao: The old iPhone OS 2.x SDK had it as "Program Name". It was changed with 3.0 SDK to "Product name".
• Luca: But renaming the project at the Product Name under Build settings-> Packaging is primordial step otherwise it will be some issues when submitting the final release.

Answer 17

It's very easy to change in Xcode 8. enter the app name in the "Display Name" field in Project Target → General Identity section.

enter image description here

Answer 18

Also: your target name may be the same as your app name. Note that changing the target name does not change the app name. Only the change in the target properties described below will change the app name.

• Aleem: Can we change the name without using Xcode ? From any command on terminal

Answer 19

You can modify the Product Name without changing your Project Name (especially the directory).

Build Settings → search the keyword "product name" → Update values

Answer 20

A note on the bundle display name: This is the right way to change the name in your app menu, but you'll likely have to reset content and settings in your iOS simulator before you see the change actually take effect.

• Peter Mortensen: Can you elaborate on that? E.g., instructions on how to do it.

Answer 21

For the sake of gathering all relevant information in one place, here is the official answer to this question - and it is the only one that worked for me on Xcode 5.1.1

Just use the Identity and Type pane in Xcode.

Use Identity and Type pane in Xcode

Answer 22

1. Select the top-most line to the left (with your project name, number of targets, etc.).
2. Select the target you wish to rename.
3. Click on the name of the target again.
4. Type the new name.
5. Press Enter.

Answer 23

For changing the application name only (that will display along with the app icon) in Xcode 4 or later:

Click on your project file icon from Groups & Files panel, choose Target → Build Settings → Packaging → Product Name. Click on the row. A pop-up will come. Type your new app name here.

For changing the project name only (that will display along with project icon) in Xcode 4 or later:

Click on your project file icon from the Groups & Files panel, choose Project (above targets) from the right pane. Just see at the far right pane (it will be visible only if you have enabled "Hide or show utilities"). Look for the project name. Edit it to a new name you want to give your project.

Delete your app from simulator/device, clean and run. Changes should reflect.

That's it.

Answer 24

I saw many ways to change your app name on the home screen, and I don't think the necessity of edit your .plist file or changing Build Settings of target is justified.

By default in Xcode 7.2 you even don't have 'bundle display name' in your plist file.

And by default, your 'Product name' in 'Build settings' tab of your target is equal to $(TARGET_NAME). IMHO, it's convenient and didn't mean to change.

So you can simply change your Target name like hallski said in his comment for accepted answer. I made picture for it:

Enter image description here

Answer 25

I think there is a bit of confusion:

• Do you want to change the project name or
• do you want to change the App name on the iOS dashboard?

Usually it is enough to change the latter, adding/modifying the BUNDLE DISPLAY NAME key in plist.

It is better to leave the project name untouched, but it may be changed.

Note that Bundle display Name can contain spaces and special characters, but project not. Doing so some cmd line tools will fail due to filename path rules.

And even more Bundle Display names can be localized.

So unless you are in early stage and need to change the internal project name, go on using the Bundle Display Name key.

Answer 26

Follow these four steps maintaining the serial number. And in step 4, give your desired name...

step 1: Click on your project

step 2: Click on the target

step 3: Click on the General tab

step 4: Under identity click on Display name and change it.

You can see details on the image.

Shortcut: -> Just look at the image

Enter image description here

• Peter Mortensen: What serial number?

Answer 27

There are

• Product name ($(PRODUCT_NAME)): defaults to Target name. This is useful for scheme to select the right target
• Bundle display name (CFBundleDisplayName): defaults to Product name. This is what is displayed to your iOS user

Answer 28

Project Navigator → General → Display Name

enter image description here

Answer 29

The easiest way: select the TARGET name, double click on it, and rename.

You'll see your app's new name underneath the icon on your device or simulator.

Answer 30

Using Javier's approach to rename my app works perfectly. There is just one small bit missing in the end that I wanted to add.

I still ended up getting a Mach-O Linker Error after a clean and rebuild. To resolve this; select yourProject (in the Project Navigator). Under Targets, select yourProjectTests (the test target) → under the General tab, update the Host Application's value to the newly renamed project.