Skip to main content

Change the App Name

Changing the visible app name is only one part of white-labeling. For production, also review bundle identifiers, Android application ids, Firebase app entries, push credentials, and store metadata.

Quick Answer​

Update the iOS display name and Android app_name, rebuild the app, and verify the label on device. If you also change the bundle identifier or Android application id, create matching Firebase app entries and download new config files.

1. Change the iOS Display Name​

Open the iOS workspace in Xcode:

open ios/*.xcworkspace

Then:

  1. select the app project;
  2. select the app target;
  3. open General or Info depending on Xcode version;
  4. update the display name value;
  5. confirm the bundle identifier if you are white-labeling for release.

You can also search native files if the display name is configured in plist or build settings:

rg "CFBundleDisplayName|PRODUCT_NAME|INFOPLIST_KEY_CFBundleDisplayName" ios

2. Change the Android Display Name​

Open:

android/app/src/main/res/values/strings.xml

Update:

<string name="app_name">Your App Name</string>

Search for additional flavor-specific values if the app has build variants:

rg "app_name" android/app/src/main/res android/app/src

3. Review App Identifiers​

For production, update identifiers intentionally:

PlatformIdentifier
iOSBundle identifier, for example com.company.app.
AndroidapplicationId, for example com.company.app.

If identifiers change, update:

  • Firebase iOS app and GoogleService-Info.plist;
  • Firebase Android app and google-services.json;
  • Apple Developer App ID and provisioning profile;
  • APNs credentials;
  • Google Play app entry;
  • third-party OAuth providers;
  • Stripe/Apple Pay merchant settings if used.

4. Rebuild and Verify​

corepack yarn ios
corepack yarn android

If the old app name remains on the home screen, delete the installed app and run again.

Verification Checklist​

  • iOS home screen shows the new app name.
  • Android launcher shows the new app name.
  • Bundle identifier/application id are correct for the target environment.
  • Firebase config files match the identifiers.
  • Push, social login, and payments still work after identifier changes.
  • Store listing name matches the release plan.

Troubleshooting​

ProblemFix
Old name still appearsDelete the installed app and rebuild.
Firebase stops working after renameDownload new Firebase config files for the new identifiers.
Social login failsUpdate provider app settings with the new bundle/package values.
Push stops workingRecreate or update APNs/FCM credentials for the new app id.

Next Steps​