How can I change the app display name build with Flutter?

Question

I have created the app using Flutter create testapp. Now, I want to change the app name from "testapp" to "My Trips Tracker". How can I do that?

I have tried changing from the AndroidManifest.xml, and it got changed, but is there a way that Flutter provides to do that?

The manifest is the only way to change the name that is shown in the Settings app and the name shown on your launcher icon. — CommonsWare, Mar 18 '18 at 21:54
For visual people this video will show you the whole process https://www.youtube.com/watch?v=05twEATiS44 — Infinite Looper, Apr 22 '19 at 04:39
Use a plugin,it's easy, fast, secure,and already tested by the comunity, the [flutter_app_name](https://pub.dev/packages/flutter_app_name) package it's a great option, and have support for null-safety. The other recommended package is [flutter_launcher_name](https://pub.dev/packages/flutter_app_name), but basically flutter_launcher_name don't support null safety, check the [Null safety support](https://github.com/daisuke-fukuda/flutter_launcher_name/issues/9). — Jesus Hernandez Barrios, Jul 28 '21 at 15:10

score 611 · Answer 1 · edited Dec 23 '22 at 11:44

611

Android

Open AndroidManifest.xml (located at android/app/src/main)

<application
    android:label="App Name" ...> // Your app name here

iOS

Open info.plist (located at ios/Runner)

<key>CFBundleDisplayName</key>
<string>App Name</string> // Your app name here

and/or

Don't forget to stop and run the app again.

edited Dec 23 '22 at 11:44

SwiftiSwift

7,528
9
56
96

answered May 08 '19 at 11:00

CopsOnRoad

237,138
77
654
440

1

For Android, this does not work. Trying to change from to , the error message sais: `Manifest merger failed : Attribute application@label value=(OldName) from AndroidManifest.xml:21:9-32 is also present at AndroidManifest.xml:21:9-32 value=(NewName).`. What do you suggest ?? – iKK May 28 '19 at 17:46
8

You may have more than one `AndroidManifest.xml` file in your project, you will have to open the one located at `android/app/src/main`. – CopsOnRoad May 29 '19 at 06:10
2

This *appears* to be all sorts of broken with the latest IOS updates and/or Catalina updates and/or Flutter updates. I have no idea. Changing this now breaks the deployment as it renames the .app folder from a consistent Runner.app to whatever you put in display name, and then "flutter run" breaks. Now, if you want to change it, you name the name: key in the YAML file, then do global search/replace on the package name. (sigh) – ChrisH Nov 12 '19 at 21:30
1

@ChrisH I am running updated version of all, and it does work as expected. – CopsOnRoad Feb 05 '20 at 10:07
what about name in pubspec.yaml – Fethi Apr 09 '21 at 10:58
1

@Fethi That's just the name of your project. For names, you'll have to edit the `AndroidManifest.xml` file (in Android) and `info.plist` (in iOS). Flutter [docs](https://flutter.dev/docs/deployment/android#reviewing-the-app-manifest) mention it too. – CopsOnRoad Apr 09 '21 at 11:32
how to add space between the app name, ios info.plist doesnt support space. – Sanal Kv Jun 10 '21 at 10:32
@CopsOnRoad is it a better practice to define the android app name inside strings.xml instead of hardcoding it? – HII Aug 05 '21 at 12:39
@HaidarMehsen Yes, you should if you're targeting different locales. – CopsOnRoad Aug 05 '21 at 15:13

score 271 · Accepted Answer · edited Mar 23 '21 at 00:54

271

UPDATE: From the comments this answer seems to be out of date

The Flutter documentation points out where you can change the display name of your application for both Android and iOS. This may be what you are looking for:

For Android

It seems you have already found this in the AndroidManifest.xml as the application entry.

Review the default App Manifest file AndroidManifest.xml located in /android/app/src/main/ and verify the values are correct, especially:

application: Edit the android:label in the application tag to reflect the final name of the app.

For iOS

See the Review Xcode project settings section:

Navigate to your target’s settings in Xcode:

In Xcode, open Runner.xcworkspace in your app’s ios folder.

To view your app’s settings, select the Runner project in the Xcode project navigator. Then, in the main view sidebar, select the Runner target.

Select the General tab. Next, you’ll verify the most important settings:

Display Name: the name of the app to be displayed on the home screen and elsewhere.

edited Mar 23 '21 at 00:54

Hasan El-Hefnawy

1,249
1
14
20

answered Mar 19 '18 at 00:49

Ashton Thomas

16,659
5
31
25

41

Yeah, thanks for the answer. I knew the native methods to do that. I was just curious to know if flutter handles it from a single point. – rajaishwary Mar 23 '18 at 14:17
6

These are native methods to do that. I want to know flutter handles it from a single point or not? – Pankaj Bansal Apr 29 '19 at 06:45
2

@AshtonThomas I can change this but after cleaning rebuilding etc, runner app resets its value, how can I keep this?(As I understand Runner project is recreated after clean build or so) – Johnykutty May 19 '19 at 23:28
5

If you change Display Name in the runner project it will stop working. It has to be ´Runner' Apparently, it is necessary to change the name and version data on the pubspeck.yaml file only, which is quite incovenient if android and ios apps have different versions or name localization – Dpedrinha Dec 12 '19 at 20:53
@Johnykutty Were you able to figure out? Am also having the same issue – Dheeraj Avvari Feb 03 '20 at 21:28
14

For iOS this is incorrect. One should change the CFBundleName in Info.plist. Flutter will not find the app, as it will look for the Runner.app, and if you change it in Xcode that is no longer the case. – pjotr_dolphin Mar 23 '20 at 13:33
1

This answer is just wrong, at least for iOS. To change the name that is displayed under the Apps icon in iOS, I had to go to App Directory > ios > Runner, open info.plist and change the 'bundle name' from 'app' to whatever I would like to call it. That is the only thing which actually worked. Changing `Runner` in `Runner.xcworkspace` will not allow you to run the app after the next build. – Muhammad bin Yusrat Apr 21 '20 at 09:41
I found a plugin to change display name of both at one location: https://pub.dev/packages/flutter_launcher_name – Tarik Hacialiogullari Mar 23 '22 at 09:00

score 56 · Answer 3 · edited Jan 08 '22 at 01:06

56

There is a plugin called flutter_launcher_name.

Write file pubspec.yaml:

dev_dependencies:
  flutter_launcher_name: "^0.0.1"

flutter_launcher_name:
  name: "yourNewAppLauncherName"

And run:

flutter pub get
flutter pub run flutter_launcher_name:main

You can get the same result as editing AndroidManifest.xml and Info.plist.

edited Jan 08 '22 at 01:06

Simon

1
1
5

answered Dec 11 '19 at 05:11

daisuke-fukuda

561
5
4

2

Nice! I'll test the plugin. But as far as I know, if you change the Display Name on the info.plist file from 'Runner', the app stops compiling. It has to be 'Runner'. – Dpedrinha Dec 12 '19 at 20:55
1

Sorry it is not working. Like Dpedrinha said, it has to be 'Runner'. – Mi Be Dec 17 '19 at 19:57
it's working for me. But i need to delete the app and reinstall it after run: `flutter pub run flutter_launcher_name:main` – Jorge Wander Santana Ureña Mar 18 '20 at 19:54
There is also a plugin to replace the icon https://pub.dev/packages/flutter_launcher_icons – Katu Apr 04 '20 at 09:58
6

The plugin was not updated for flutter 2.0 and has dependency issues – Ride Sun Apr 01 '21 at 20:41
I had the followin error that went away when I removed the `flutter_launcher_name` dependency: `Flutter – Error: ADB exited with exit code 1` – Joaquin Hoffmann Jun 14 '21 at 21:00
There is a paliative solution for the problem with the plugin [according to this comment](https://github.com/daisuke-fukuda/flutter_launcher_name/issues/12#issuecomment-812217297) – Isac Moura Jun 22 '21 at 02:50
2

This plugin is no longer valid as it has not been upgraded to Flutter 2, so you will run into dependency issues. `flutter_app_name` (https://pub.dev/packages/flutter_app_name) is a nearly identical plugin but works with Flutter 2.0. – Max00355 Jun 30 '21 at 00:22

score 37 · Answer 4 · answered Sep 21 '18 at 18:27

You can change it in iOS without opening Xcode by editing the project/ios/Runner/info.plist <key>CFBundleDisplayName</key> to the String that you want as your name.

FWIW - I was getting frustrated with making changes in Xcode and Flutter, so I started committing all changes before opening Xcode, so I could see where the changes show up in the Flutter project.

score 16 · Answer 5 · edited Jan 17 '21 at 06:52

16

Review the default app manifest file, AndroidManifest.xml, located in <app dir>/android/app/src/main
Edit the android:label to your desired display name

edited Jan 17 '21 at 06:52

Peter Mortensen

30,738
21
105
131

answered Mar 14 '19 at 11:02

Achyut

703
9
19

Kab Agouda · Answer 6 · 2021-02-06T23:54:22.560

There are several possibilities:

1- The use of a package:

I suggest you to use flutter_launcher_name because of the command-line tool which simplifies the task of updating your Flutter app's launcher name.

Usage:

Add your Flutter Launcher name configuration to your pubspec.yaml file:

dev_dependencies:
  flutter_launcher_name: "^0.0.1"

flutter_launcher_name:
  name: "yourNewAppLauncherName"

After setting up the configuration, all that is left to do is run the package.

flutter pub get
flutter pub run flutter_launcher_name:main

If you use this package, you don't need modify file AndroidManifest.xml or Info.plist.

2- Edit `AndroidManifest.xml` for Android and `info.plist` for iOS

For Android, edit only android:label value in the application tag in file AndroidManifest.xml located in the folder: android/app/src/main

Code:

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application
        android:name="io.flutter.app.FlutterApplication"
        android:label="Your Application Name"  //here
        android:icon="@mipmap/ic_launcher">
        <activity>
        <!--  -->
        </activity>
    </application>
</manifest>

Screenshot:

For iOS, edit only the value inside the String tag in file Info.plist located in the folder ios/Runner .

Code:

<plist version="1.0">
<dict>
    <key>CFBundleName</key>
    <string>Your Application Name </string>  //here
</dict>
</plist>

Screenshot:

Do a flutter clean and restart your application if you have a problem.

score 9 · Answer 7 · answered Jun 30 '21 at 00:29

A few of the answers here suggest using the package flutter_launcher_name, but this package is no longer being maintained and will result in dependency issues within new Flutter 2.0 projects.

The plugin flutter_app_name (https://pub.dev/packages/flutter_app_name) is a nearly identical package that has sound null safety and will work with Flutter 2.0.

Set your dev dependencies and your app's name

dev_dependencies:
  flutter_app_name: ^0.1.1

flutter_app_name:
  name: "My Cool App"

Run flutter_app_name in your project's directory

flutter pub get
flutter pub run flutter_app_name

Your launcher will now have the name of "My Cool App".

Moaz El-sawaf · Answer 8 · 2023-07-29T03:17:00.553

9

You can easily do this with rename package, It helps you to change your Flutter project's AppName and BundleId for any platform you want and it is currently supporting all the 6 platforms (Android, IOS, Linux, macOS, Windows, and Web).

To install the package run the following command:

flutter pub global activate rename

To rename the App, use the following command:

flutter pub global run rename --appname "Your App Name"

That's It!

You can check the documentation of the package for full details because it has some nice features to choose the target platform and more.

edited Jul 29 '23 at 03:17

answered Jun 11 '22 at 08:04

Moaz El-sawaf

2,306
1
16
33

1

Great solution. I use this package for renaming projects too. You may need to add flutter before pub – zizutg Jul 29 '23 at 02:13
1

Great Solution. Thanks – Tariq Mahmood Jul 30 '23 at 20:23

score 8 · Answer 9 · edited Jan 17 '21 at 06:59

8

You can change it in iOS without opening Xcode by editing file *project/ios/Runner/info.plist. Set <key>CFBundleDisplayName</key> to the string that you want as your name.

For Android, change the app name from the Android folder, in the AndroidManifest.xml file, android/app/src/main. Let the android label refer to the name you prefer, for example,

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    <application
        android:label="test"
        // The rest of the code
    </application>
</manifest>

edited Jan 17 '21 at 06:59

Peter Mortensen

30,738
21
105
131

answered Aug 05 '20 at 11:56

Braken Mohamed

194
1
16

Shouldn't the tag `application` be closed after `android:label="test"`? Or is all of "The rest of the code" (XML) attributes? – Peter Mortensen Jan 17 '21 at 07:00
yes it should be closed last after all the tags cuz it's the parent of all tags – Braken Mohamed Jan 29 '21 at 23:27
this answer worked for me, setting CFBundleDisplayName to the new app name. other answers said set CFBundleName to the app name, but that did not work for me. – tmr Feb 28 '23 at 05:24

score 7 · Answer 10 · answered Feb 18 '22 at 12:19

You can change the Application name, by updating the name for both Android and iOS

for Android

just open AndroidManifest.xml file by,

go to inside android>app>src>main>AndroidManifest.xml

like this:-

so my application name is a "demo" so, I will update the label value.

same as for iOS just open Info.plist file by,

go to inside ios>Runner>Info.plist

like this:-

And change this string value.

score 5 · Answer 11 · answered Jan 18 '19 at 04:40

5

One problem is that in iOS Settings (iOS 12.x) if you change the Display Name, it leaves the app name and icon in iOS Settings as the old version.

answered Jan 18 '19 at 04:40

mikeyman22

383
4
7

3

what helped me: go to "Info" Tab and change "Bundle name". – Mi Be Dec 17 '19 at 19:35

score 5 · Answer 12 · edited Jan 06 '21 at 17:08

5

For Android, change the app name from the Android folder. In the AndroidManifest.xml file, in folder android/app/src/main, let the android label refer to the name you prefer, for example,

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    <application
        `android:label="myappname"`
        // The rest of the code
    </application>
</manifest>

edited Jan 06 '21 at 17:08

Peter Mortensen

30,738
21
105
131

answered Sep 18 '19 at 21:05

Maureen Josephine

476
5
3

Should the [backticks](https://en.wiktionary.org/wiki/backtick#Noun) literally be there? – Peter Mortensen Jan 06 '21 at 17:08

score 4 · Answer 13 · answered Apr 28 '23 at 15:35

Android

android/app/src/main/AndroidManifest.xml

<application
    android:label="Display Name" // <---- HERE

iOS and macOS

ios/runner/Info.plist

<key>CFBundleDisplayName</key>
<string>Display Name</string> // <---- HERE

Windows

windows/runner/Runner.rc

BEGIN
    VALUE "CompanyName", "com.company" "\0"
    VALUE "FileDescription", "Display Name" "\0" // <---- HERE
    VALUE "FileVersion", VERSION_AS_STRING "\0"
    VALUE "InternalName", "Display Name" "\0" // <---- HERE
    VALUE "LegalCopyright", "Copyright (C) 2023 com.company. All rights reserved." "\0"
    VALUE "OriginalFilename", "appname.exe" "\0"
    VALUE "ProductName", "Display Name" "\0" // <---- HERE
    VALUE "ProductVersion", VERSION_AS_STRING "\0"
END

windows/CMakeLists.txt (and not windows/runner/CMakeLists.txt)

set(BINARY_NAME "appname") // <---- HERE TO CHANGE OUTPUT FILE appname.exe

windows/runner/main.cpp

if (!window.Create(L"Display Name", origin, size)) {
    return EXIT_FAILURE;
}

score 3 · Answer 14 · edited Jan 15 '23 at 14:41

3

I saw indeed the manual solution (to go to IOS and Android). But I found out a plugin which enables changing name from one single location:

https://pub.dev/packages/flutter_launcher_name

Just do the following: Add to pubspec.yaml

dev_dependencies: 
  flutter_launcher_name: "^0.0.1"
  
flutter_launcher_name:
  name: "yourNewAppLauncherName"

Run in Terminal:

flutter pub get
flutter pub run flutter_launcher_name:main

Done.

edited Jan 15 '23 at 14:41

halfer

19,824
17
99
186

answered Mar 23 '22 at 09:03

Tarik Hacialiogullari

171
11

3

A more recent version of this module, compatible with Flutter 2 and with null safety, is https://pub.dev/packages/flutter_app_name – bolino May 16 '22 at 07:26
1

Even newer than the published package is the repo itself: https://github.com/f-prime/flutter_app_name which includes changes to support setting the bundleId (iOS) / applicationId (android) thanks to [PR1](https://github.com/f-prime/flutter_app_name/pull/1) – qix May 18 '22 at 10:02

score 2 · Answer 15 · edited Jan 17 '21 at 06:54

2

As of 2019-12-21, you need to change the name [NameOfYourApp] in file pubspec.yaml. Then go to menu Edit → Find → Replace in Path, and replace all occurrences of your previous name.

Also, just for good measure, change the folder names in your android directory, e.g. android/app/src/main/java/com/example/yourappname.

Then in the console, in your app's root directory, run

flutter clean

edited Jan 17 '21 at 06:54

Peter Mortensen

30,738
21
105
131

answered Dec 21 '19 at 08:58

Philip

638
1
8
22

2

I wonder how you put display name in pubspec with all spaces, cyrillic letters, etc. – Олександр Бабіч Dec 25 '19 at 15:52

score 2 · Answer 16 · answered Jul 26 '22 at 08:52

in case you are releasing for multi-localizations (languages).

for Android:

in your app folder at [appname]\android\app\src\main\res add locale folders for example:

values-ar

valuse-en

then inside each folder add a new strings.xml that contains the app name in that language.

for ar

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string name="app_name">ادارة الديون</string>
</resources>

for en

<?xml version="1.0" encoding="UTF-8"?>
    <resources>
        <string name="app_name">debt management</string>
    </resources>

The last thing you can do is go to your AndroidManifest.xml file and set the android:label to the new files you have created.

android:label="@string/app_name"

score 1 · Answer 17 · answered Feb 14 '21 at 13:55

First Rename your AndroidManifest.xml file

android:label="Your App Name"

Second Rename Your Application Name in Pubspec.yaml file name: Your Application Name

Third Change Your Application logo

flutter_icons:
   android: "launcher_icon"
   ios: true
   image_path: "assets/path/your Application logo.formate"

Fourth Run

flutter pub pub run flutter_launcher_icons:main

score 0 · Answer 18 · answered Oct 22 '22 at 03:33

If you like to automate stuff from command line like me, you can use this

appName="TestApp"
declare -a androidAppTypes=(
    "main"
    "debug"
    "profile"
)

# Change app name for Android
for appType in ${androidAppTypes[@]}
do
    xmlstarlet ed -L -u '/manifest/application/@android:label' -v "$appName" android/app/src/$appType/AndroidManifest.xml
done

# Change app name for Android
plutil -replace CFBundleDisplayName -string "$appName" ios/Runner/Info.plist

score -1 · Answer 19 · edited Jan 17 '21 at 06:57

The way of changing the name for iOS and Android is clearly mentioned in the documentation as follows:

But, the case of iOS after you change the Display Name from Xcode, you are not able to run the application in the Flutter way, like flutter run.

Because the Flutter run expects the app name as Runner. Even if you change the name in Xcode, it doesn't work.

So, I fixed this as follows:

Move to the location on your Flutter project, ios/Runner.xcodeproj/project.pbxproj, and find and replace all instances of your new name with Runner.

Then everything should work in the flutter run way.

But don't forget to change the name display name on your next release time. Otherwise, the App Store rejects your name.

How can I change the app display name build with Flutter?

19 Answers19

Android

iOS

and/or

There are several possibilities:

1- The use of a package:

2- Edit `AndroidManifest.xml` for Android and `info.plist` for iOS

Android

iOS and macOS

Windows

Linked

How can I change the app display name build with Flutter?

19 Answers19

Android

iOS

and/or

There are several possibilities:

1- The use of a package:

2- Edit AndroidManifest.xml for Android and info.plist for iOS

Android

iOS and macOS

Windows

Linked

2- Edit `AndroidManifest.xml` for Android and `info.plist` for iOS