By Robert Gould


2008-10-27 03:07:03 8 Comments

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.

But I'm not sure how to do this with Xcode, trying the obvious of changing the application's name in the info.plist file, causes the signing process to go wrong (I think...) and my app won't launch giving me a Launcher error.

I guess I could make a new project and copy paste everything over, but it seems so primitive that I'm hoping for a more civilized solution.

30 comments

@midhun p 2018-10-01 11:33:17

Step 1 - Rename the project

Click on the project you want to rename in the "Project navigator" on the left of the Xcode view.
On the right select the "File inspector" and the name of your project should be in there under "Identity and Type", change it to the new name.
Click "Rename" in a dropdown menu

Step 2 - Rename the Scheme

In the top bar (near "Stop" button), there is a scheme for your OLD product, click on it, then go to "Manage schemes"
Click on the OLD name in the scheme, and it will become editable, change the name

Step 3 - Rename the folder with your assets

Quit Xcode
In the correctly named master folder, there is a newly named xcodeproj file with the the wrongly named OLD folder. Rename the OLD folder to your new name
Reopen the project, you will see a warning: "The folder OLD does not exist", dismiss the warning
In the "Project navigator" on the left, click the top level OLD folder name
In Utilities pane under "Identity and type" you will see the "Name" entry, change this from the OLD to the new name
Just below there is a "Location" entry. Click on a folder with the OLD name and chose the newly renamed folder

Step 4 - Rename the Build plist data

Click on the project in the "Project navigator" on the left, in the main panel select "Build Settings"
Search for "plist" in this section
Under packaging, you will see Info.plist, and Product bundle identifier
Rename the top entry in Info.plist
Do the same for Product Identifier

Finally, you are done and can rebuild (Command + Shift + K to clean, Command + B to build)

When using CocoaPods After step 2:

Quit XCode.
In the master folder, rename OLD.xcworkspace to NEW.xcworkspace.

After step 4:

In XCode: choose and edit Podfile from the project navigator. You should see a target clause with the OLD name. Change it to NEW.
Quit XCode.
In the project folder, delete the OLD.podspec file.
rm -rf Pods/
Run pod install.
Open XCode.
Click on your project name in the project navigator.
In the main pane, switch to the Build Phases tab.
Under Link Binary With Libraries, look for libPods-OLD.a and delete it.
If you have an objective-c Bridging header go to Build settings and change the location of the header from OLD/OLD-Bridging-Header.h to NEW/NEW-Bridging-Header.h
Clean and run.

@Javier Cadiz 2013-12-06 08:06:02

In new versions of Xcode (Xcode 5 too) to change the name of the project follow this 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.

@Christopher Marshall 2014-05-05 17:56:18

The "Another scenario" part worked perfectly. Thanks!

@marcel salathe 2014-06-03 05:02:45

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 2014-08-12 15:53:15

Had the same problem as @marcelsalathe, his fix solved the issue. Ideally this should be added to Javier Cadiz's answer.

@DeveloperACE 2015-12-27 15:56:18

Does this work in Xcode 7?

@Steve Moser 2016-01-21 20:48:00

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 2016-05-18 04:39:30

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.

@Lucas P. 2018-02-27 10:17:38

Thankyou so much for the detailed explanation! :)

@SilverWolf 2018-04-03 20:15:04

Important note: This won't rename some files and folders! You can use some sed magic to fix this afterward, though.

@drew.. 2018-05-17 18:54:53

This should be a good route but will lead most devs to a lost day or two. It is such a nightmare, especially if you have a bunch of pods active. I'd highly suggest Sahil Kapoor's advice above, and REALLY REALLY ponder a project's name prior to starting.

@Joshua Dance 2018-07-10 05:29:51

This should be the accepted answer now.

@Deepnarain Rai 2017-10-12 06:58:19

select project navigator > select Target > Identity > Display Name > Name

@Ved Rauniyar 2017-05-18 09:00:30

You can change from info.plist having attribute "Bundle Name" .

@Deian 2018-08-25 03:50:59

this is the only thing that worked for me on xcode9

@Dan Rosenstark 2016-01-12 19:56:10

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

enter image description here

@Viktor Kucera 2016-11-29 12:03:28

Works for Xcode 8 as well.

@Alex Cio 2017-05-10 22:36:51

Great answer! works fine!

@Ankit garg 2016-12-30 16:27:48

Project Navigator>General>Display Name

enter image description here

@Biranchi 2016-12-12 19:15:30

Its 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

@onmyway133 2016-11-30 10:31:00

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

@Giao 2008-10-27 03:30:28

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

@Simon Woodside 2009-08-21 20:41:41

I had to quit XCode and delete my build directory before it would take for me.

@Tony Eichelberger 2010-01-20 22:31:36

Also, remember to change this in each of the configurations! (Debug, Release, Ad Hoc, App Store, etc)

@Hamy 2010-05-01 01:37:49

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 ;)

@Newbyman 2010-07-03 14:59:40

Example of above comment: 2010-07-03 10:56:35.129 OldAppName [45672.207] Test Message - Even though I have changed the Product_name, ".app" name Bundle name, etc... - Where does "Console" get this name, so I can truly change the app's name 100%?

@Akshay 2011-02-25 06:58:06

Don't know why am I an exception but It didn't worked for me :(

@hallski 2011-04-15 08:12:38

In Xcode 4 you can simply double click the target name and change it directly in the target list.

@jinglesthula 2011-08-01 17:40:26

After doing the mentioned steps I get a Code Sign error: The identity 'bla' doesn't match any identity in any profile.

@PapillonUK 2013-08-03 16:05:27

This needs updating, the given answer and associated comments are very confusing and don't seem to match what I see in Xcode 5.x

@Jay Mayu 2013-09-03 11:13:08

In latest version of xcode I get error saying "unable to change app permission something after changing the name". All I did was uninstall the app and ran the ">" button again. It worked like magic

@Martin Berger 2013-09-25 09:11:13

If your app uses iCloud or Push Notifications or some other service, and you change Product Name you will also need to recreate Provisioning Profile for your app. But still, that is far better than renaming project folder in Finder and then re-include all files into Xcode :)

@aledustet 2014-01-15 17:11:21

@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

@Neocy 2014-05-12 16:07:42

Updating bundle display name worked for me.

@Gabox 2014-06-14 20:29:07

This is not a good answer, if you change the name in following this steps your unit test are not going to work!

@Ammar Mujeeb 2015-05-08 12:10:27

After selecting Target. Find "Product Name" in "Packaging" under build settings.

@Josh 2015-06-25 08:58:53

@hallski (1000 yrs later... ) It still works in Xcode6!

@Wilmer 2016-10-24 12:07:27

Go to Targets / Build Settings / and look for Packaging to change Product Name. My app uses CloudKit and works fine (XCode 8, Swift 3)

@Ravi 2017-03-24 14:58:12

In Xcode >= 8 just select target > General tab and write your app new name in "Display Name" Column. Done!!

@James Bush 2017-07-03 22:02:07

Does not work. Why is this crap answer being protected?

@Debaprio B 2018-03-19 17:45:53

If you have localization, change the 'CFBundleDisplayName' key in InfoPlist.strings file.

@ingconti 2016-02-24 07:32:55

I think there is a bit of confusion:

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

usually is enough to change the latter, adding/modifying the BUNDLE DISLAY NAME key in plist.

Is better to leave project name untouched, but may be changed

Note that Bundle display Name CAN contain spaces and special chars, but project NOT. Doing so some cmd line tools will fails due to filename path rules.

And even more Bundle Display name can be localized.

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

@surfrider 2015-12-19 12:03:01

I saw many ways to change your app name on homescreen, 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 pic for it: enter image description here

@Alex Cio 2013-04-24 11:03:05

1. Select Target

enter image description here

2. Select Info

enter image description here

3. Insert Bundle Display Name and set App Title

enter image description here

@Aviel Gross 2014-04-04 20:49:21

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...

@rsc 2015-01-13 20:20:07

The best solution if you just need to update the icon name.

@Max Friedman 2015-06-06 03:40:32

The link below works for Xcode 6, especially if you are getting an error after trying to rename your project. Basically, just try building a new scheme of your app.

https://stackoverflow.com/a/27572164/4114835

@parvind 2015-03-30 05:01:26

In Target>Build Setting>Product name field you can edit that field here.

@Lester 2015-03-12 12:29:46

Using Javier's approach to rename my app works perfectly. There is just one small bit missing in the end that I wanted 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.

@Jeffrey Neo 2014-12-11 08:49:23

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

Build Settings > search the keyword "product name" > update values

@xscoder 2014-11-28 22:11:24

Easiest way: select the TARGET name, double click on it, rename. You'll see your app's new name underneath the icon on your device or Simulator.

@djdance 2016-01-20 15:49:31

on XCode 7 gets error trying to run on ios7 :(

@xscoder 2016-01-20 16:01:54

that's wired, we've done that so many times since iOS 7.0

@ytbryan 2014-09-14 12:16:11

I am using this script after I rename my iOS Project. It helps to change the directories name and make the names in sync.

http://github.com/ytbryan/rename

NOTE: you will need to manually change the scheme's name.

@C0D3LIC1OU5 2014-09-11 18:06:19

For 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

@poordeveloper 2014-02-13 15:53:31

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

enter image description here

@Akshay 2011-02-22 05:53:39

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, 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, 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: Viola! Do a clean then build and your application will take on the new name.

@Yogi 2012-01-30 07:38:20

From Xcode 4.2 and onwards, you can use one more option. Just click once on .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.

Hope this helps

@Alok 2013-05-28 14:37:19

For changing application name only (that will display along with 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 Project name only (that will display along with project icon) in xcode 4 or later:

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

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

That's it

@Roger C S Wernersson 2012-12-03 14:30:34

  1. Select the top most line to the left (with you 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.

@Noel 2012-10-24 11:03:57

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.

@Atma 2009-12-24 23:38:52

You change the bundle display name in the info.plist. 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 the app store!

@ExceptionSlayer 2013-01-30 04:19:25

this is better than changing the target name as it avoids conflict and mess-ups in game engines

@j2emanue 2013-04-01 15:07:24

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 2013-09-06 03:47:35

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 2013-12-15 12:54:17

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 2015-06-10 02:43:24

If 'Bundle display name' is not shown, then simply add it.

@Code Hunter 2012-10-12 12:09:32

If you want to change display name only then you can directly change from property file(plist) of 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 will be display.

So you can do this simply.

@Dilip Rajkumar 2011-09-10 11:41:05

This is how I changed in Xcode 4:

  1. Click on your Target file (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, you can change project name.

@Orion Edwards 2015-02-02 22:47:50

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

@Nareille 2011-10-17 10:19:16

If you wanna 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.

@Konstantin Salavatov 2011-07-06 12:06:15

In Xcode 4 click on project name to start renaming.

@Joe Regan 2009-07-29 14:25:44

I saw the setting as "Product Name" not "Project Name" - in any case, the change worked.

@Giao 2010-01-12 00:25:29

The old iPhone OS 2.x SDK had it as "Program Name". It was changed with 3.0 SDK to "Product name".

@Luca 2012-04-15 15:49:26

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.

Related Questions

Sponsored Content

22 Answered Questions

[SOLVED] How to link to apps on the app store

20 Answered Questions

[SOLVED] I get conflicting provisioning settings error when I try to archive to submit an iOS app

  • 2016-11-27 00:52:42
  • vanagar
  • 89348 View
  • 193 Score
  • 20 Answer
  • Tags:   ios xcode

39 Answered Questions

[SOLVED] How to check for an active Internet connection on iOS or macOS?

13 Answered Questions

[SOLVED] How do I animate constraint changes?

90 Answered Questions

[SOLVED] How can I make a UITextField move up when the keyboard is present?

51 Answered Questions

[SOLVED] How to change Status Bar text color in iOS

1 Answered Questions

[SOLVED] Adjusting the name of an unreleased iOS App

1 Answered Questions

1 Answered Questions

Will changing the only the bundle name cause problems uploading app to iTunes?

  • 2015-08-21 17:19:37
  • NoClue
  • 63 View
  • 1 Score
  • 1 Answer
  • Tags:   ios

1 Answered Questions

iAd banner doesn't load at all for iPhone 6/6+

Sponsored Content