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?
asked Oct 27, 2008 at 3:07
-
I've had to do this a few times. I use a tool called Rename Xcode Project 2.1.– NosrednaJun 10, 2009 at 0:58
-
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– Jeffrey BerthiaumeJul 29, 2009 at 14:29
-
Here's a free utility that does this and works well in my experience: change the name of an iPhone app– Frank SchmittJan 12, 2010 at 0:46
-
1@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– JJDSep 15, 2010 at 16:39
-
1Note: You can also change it in InfoPlist.strings so that it's localized for different languages.. Somehow no one posted an answer for that :(– BrandonNov 10, 2018 at 19:34
|
Show 3 more comments
37 Answers
- Go to Targets in Xcode.
- Build Settings on your project's target (your current development name).
- Search for Product Name under Packaging. Change its value to what you want your new project name to be.
-
13I had to quit XCode and delete my build directory before it would take for me. Aug 21, 2009 at 20:41
-
10Also, remember to change this in each of the configurations! (Debug, Release, Ad Hoc, App Store, etc) Jan 20, 2010 at 22:31
-
11For 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 ;)– HamyMay 1, 2010 at 1:37
-
330In Xcode 4 you can simply double click the target name and change it directly in the target list.– hallskiApr 15, 2011 at 8:12
-
11@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 Jan 15, 2014 at 17:11
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.
Click twice slowly on the project root in the project navigator and then it becomes editable.
Rename the project.
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.
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).
In addition to renaming the project, you may want to rename the scheme so that it matches your new project name.
Repeat similar steps like 1 and 2, and press OK.
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:
In the "Supporting Files" group locate the info.plist (or related) file
Locate the "Bundle display name" key and change the value to the new name.
Delete the "old" app from the simulator or any other testing device.
Clean and rebuild your app again.
That's it. You will now see the new app name in your home screen.
answered Dec 6, 2013 at 8:06
-
5The 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/… Jun 3, 2014 at 5:02
-
2Had the same problem as @marcelsalathe, his fix solved the issue. Ideally this should be added to Javier Cadiz's answer.– mattsvenAug 12, 2014 at 15:53
-
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/… Jan 21, 2016 at 20:48
-
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.– RyanMay 18, 2016 at 4:39
-
Important note: This won't rename some files and folders! You can use some
sedmagic to fix this afterward, though. Apr 3, 2018 at 20:15
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!
-
7this is better than changing the target name as it avoids conflict and mess-ups in game engines Jan 30, 2013 at 4:19
-
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).– j2emanueApr 1, 2013 at 15:07
-
14This 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). Sep 6, 2013 at 3:47
-
5This is by far the superior solution! JUST changes the name under the icon, and not bundle identifiers which mess up provisioning profiles Dec 15, 2013 at 12:54
-
3
In Xcode 4, search for "Product Name" under "Build Settings" tab of the target.
answered Apr 7, 2011 at 17:18
-
7This is a bad answer, if you do that your test project won't run Jun 14, 2014 at 20:54
-
3
-
2This 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.– MiMoJan 8, 2015 at 15:52
Select Target
Select Info
Insert Bundle Display Name and set App Title
-
6This 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... Apr 4, 2014 at 20:49
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:
When you use this the app name, which you have given with this key, it will be displayed.
So you can do this simply.
answered Oct 12, 2012 at 12:09
-
Note = The start of "bundle" have to be capatilized... Correct one is : "Bundle display name"– UcdemirDec 3, 2020 at 6:57
This is how I changed it in Xcode 4:
- Click on your target file (the first main file of the application).
- Go to Build Settings.
- Scroll down you will find a bar called "Packaging".
- Under Packaging you will see Product Name, and you can change the project name.
answered Sep 10, 2011 at 11:41
-
1This 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 Feb 2, 2015 at 22:47
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.
0
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).
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).
Step 3A: You can change the Product Name or you can also change the Target Name by double clicking on the target.
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.
answered Jul 1, 2019 at 19:02
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>
-
-
-
@PeterMortensen Yes its a file and it has your applications configurations in it Apr 15, 2021 at 10:13
-
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.– GreenJan 20, 2023 at 1:24
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.
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.
answered Feb 13, 2014 at 15:53
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.
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.
Press Command + I to bring up the Info window, and then navigate to the Build tag.
Set the Configuration drop-down to read All Configurations.
Look for a setting called Product Name under the Packaging heading.
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.
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.
In Xcode 4, click on project name to start renaming.
answered Jul 6, 2011 at 12:06
-
I saw the setting as "Product Name" not "Project Name" - in any case, the change worked. Jul 29, 2009 at 14:25
-
1The old iPhone OS 2.x SDK had it as "Program Name". It was changed with 3.0 SDK to "Product name".– GiaoJan 12, 2010 at 0:25
-
1But renaming the project at the
Product NameunderBuild settings-> Packagingis primordial step otherwise it will be some issues when submitting the final release.– LucaApr 15, 2012 at 15:49
It's very easy to change in Xcode 8. enter the app name in the "Display Name" field in Project Target → General Identity section.
answered Dec 12, 2016 at 19:15
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.
-
Can we change the name without using Xcode ? From any command on terminal– AleemSep 7, 2021 at 6:28
You can modify the Product Name without changing your Project Name (especially the directory).
Build Settings → search the keyword "product name" → Update values
answered Dec 11, 2014 at 8:49
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.
-
Can you elaborate on that? E.g., instructions on how to do it. Apr 10, 2021 at 22:44
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.
answered Sep 11, 2014 at 18:06
- Select the top-most line to the left (with your project name, number of targets, etc.).
- Select the target you wish to rename.
- Click on the name of the target again.
- Type the new name.
- Press Enter.
answered Dec 3, 2012 at 14:30
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.
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:
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.
Project Navigator → General → Display Name
There are
Product name($(PRODUCT_NAME)): defaults toTarget name. This is useful forschemeto select the right targetBundle display name(CFBundleDisplayName): defaults toProduct name. This is what is displayed to your iOS user
answered Nov 30, 2016 at 10:31
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
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.
answered Nov 28, 2014 at 22:11
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.
