How to Rename an Xcode Project Without Losing Your Mind

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.
File inspector example
  1. A dialog will display, listing the items in your project that can be renamed. Confirm everything looks right and click “Rename”
Example rename dialogue in Xcode (Source: digitalleaves.com)

Step 2- Renaming the schema

  1. In the top bar (near “Stop” button), there is a scheme with your “OLD” name, click on it, then go to “Manage Schemes”. Alternatively, you can find “Manage Schemes” here: Product > Scheme > Manage Schemes
Manage Schemes
  1. Click on the “OLD” name in the scheme, and it will become editable, change the name to “NEW”.

Step 4 — Renaming the folder with your assets

  1. Open your project folder and rename OLD.xcworkspace to NEW.xcworkspace.

Step 5 — Renaming in the Podfile

  1. In the terminal, cd into project directory & open Podfile. You should see a target clause with the “OLD” name. Change it to “NEW” and SAVE.

Step 6 — Renaming the Build .plist Data

  1. Reopen your Xcode project. You will see the following warning: “The folder OLD does not exist”, dismiss the warning and continue with the following steps.
Change the Info.plist
  1. Do the same for the “Product Identifier”.

Step 7 — Clean and Build the Project

  1. Command + Shift + K to clean

…and voila! Your project should build and run perfectly with its new name.

Thanks for reading!

Also be sure to check out my website, Twitter, LinkedIn, and Github.

writing about life, culture, and technology.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store