How to Rename an Xcode Project Without Losing Your Mind

Ahad Sheriff
3 min readDec 23, 2019
Xcode 11 Demo at WWDC19

I was recently working on an iOS app when I found myself in need of renaming my project. This can be useful if you ever need to make a copy of one of your projects to serve as a basis for further development or want to completely overhaul your app’s branding. Unfortunately, the process of refactoring can get a bit complicated in Xcode 11, especially if you are using Cocoapods, additional libraries, or have several subfolders and schemas. In this short tutorial, I will explain how to comprehensively rename your Xcode project without breaking anything in 7 straightforward steps.

Step 1 — Renaming the project

  1. If you are using Cocoapods in your project, close the workspace, and open the XCode project to complete the following steps.
  2. Select the project you want to rename in the “Project Navigator” which can be found on the left side of the Xcode view.
  3. On the right-hand side of the window, select the “File Inspector”. The name of your project should be in there under “Identity and Type”, change it to “NEW” and press Enter.
File inspector example
  1. A dialog will display, listing the items in your project that can…