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

The display name and the application identity are different settings. You can change the name users see without changing the identifier used by stores, signing, push notifications, deep links, and backend credentials.

Published application identifiers are not rename fields

For Android, changing applicationId creates a different app identity in Google Play. For Apple platforms, a bundle ID associated with an uploaded build cannot be changed for that app record. If an app has already shipped, keep the existing identifiers unless you intentionally plan a new store listing and a separate migration. See the official Android application ID guidance and Apple's bundle identifier guidance.

For a new, unpublished app or a deliberate white-label build, update identifiers intentionally:

Platform	Identifier
iOS	Bundle identifier, for example com.company.app.
Android	applicationId, 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.
• URL schemes and universal/app links;
• App Groups, Associated Domains, Keychain groups, and other entitlements;
• notification service, share, widget, watch, and other extension identifiers;
• CI, environment, analytics, crash-reporting, and credential mappings that use the old identifier.

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.
• Published store identities were left unchanged unless a new app record is the explicit release plan.
• Firebase config files match the identifiers.
• Extensions, URL schemes, App Groups, Associated Domains, and entitlements use the intended identifiers.
• Push, social login, and payments still work after identifier changes.
• Store listing name matches the release plan.

Troubleshooting

Problem	Fix
Old name still appears	Delete the installed app and rebuild.
Firebase stops working after rename	Download new Firebase config files for the new identifiers.
Social login fails	Update provider app settings with the new bundle/package values.
Push stops working	Recreate or update APNs/FCM credentials for the new app id.

Next Steps

• Change the App Icon
• Change the Splash Screen Logo
• Firebase Project Setup