How to Change App Name and Icon in Flutter: A Step-by-Step Guide

Hello flutter developers! In the ever-changing world of mobile apps, something really interesting is happening. You see, nowadays, making a strong impact on users is more important than ever. And that’s where we start talking about branding and customization. It’s like giving your app its own personality!

Think about it – a well-defined brand identity does more than just make your app stand out. It’s like a handshake that introduces your app to the people who might love it. You know how they say, “you never get a second chance to make a first impression”? Well, in the app world, the first things people notice are the name and the icon of your app.

Now, here’s where Flutter comes into the picture. Flutter is like a super versatile toolkit for making apps that work on both iPhones and Android phones. It’s gained a lot of fans among developers because it’s user-friendly and super powerful. But guess what? Flutter lets you do something really cool – you can actually change the name and the icon of your app.

So, here’s the exciting part – in this tutorial, we’re going to take a deep dive into how you can change the name and icon of your Flutter app. It might sound small, but trust me, it can make a big difference. Your app can shine bright and leave a mark on people’s minds.

So, let’s get started on this adventure of giving your app a unique identity. We’re going to learn how to change app name and icon in flutter, and by the end of this, you’ll have your app looking and feeling just the way you want it. Ready? Let’s go!


Before we dive into the process of changing the app name and icon in Flutter, there are a couple of prerequisites that you need to ensure are in place:

  1. Flutter SDK Installation: To begin, you’ll need to have the Flutter Software Development Kit (SDK) installed on your system. The Flutter SDK provides the necessary tools and libraries to develop Flutter applications. If you haven’t already installed it, you can follow the official installation guide provided by Flutter to get started.
  2. Familiarity with Flutter Project Structure: While this tutorial aims to guide you through the process step by step, having a basic understanding of the Flutter project structure will be beneficial. This includes being familiar with concepts such as the lib directory, pubspec.yaml file, and the organization of Flutter widgets.

Having these prerequisites in place will ensure a smooth journey as we explore the process of changing the app name and icon in your Flutter application. If you’re all set with these prerequisites, let’s move on to the exciting part of customizing your app’s identity!

Step 1: Changing the App Name In Flutter

In this section, we’ll walk you through the process of changing the app name in your Flutter project. The app name plays a pivotal role in how users perceive your application and contributes significantly to the overall branding. Let’s get started by understanding the importance of the app name and then proceed to the practical steps of making the change.

1. Understanding the Importance of App Name

The app name is often the first interaction users have with your application. It’s not just a label; it’s a representation of your app’s identity. A well-chosen app name can convey the purpose, value, and essence of your app to potential users. It sets the tone for user expectations and can leave a lasting impression. Additionally, the app name contributes to the app’s discoverability in app stores and search engines. A unique and memorable name can make your app stand out from the competition.

2. Locating the App Name in Flutter Project

The app name is typically defined in the pubspec.yaml file of your Flutter project. This file serves as the heart of your project configuration, including dependencies, metadata, and more. To locate the app name, follow these steps:

  • Open your Flutter project in your preferred code editor.
  • Navigate to the root directory of your project.
  • Look for a file named pubspec.yaml and open it.

3. Editing the App Name in Flutter

Once you’ve located the pubspec.yaml file, you’ll find a section where the app name is defined. It looks something like this:

name: your_app_name

Replace your_app_name with the desired name for your app. Ensure that the name you choose aligns with your app’s branding and purpose.

4. Updating the App Name in Code

After changing the app name in the pubspec.yaml file, you might wonder how to use this updated name in your app’s user interface. Here’s a simple example of how you can achieve this:

import 'package:flutter/material.dart';

void main() {

class MyApp extends StatelessWidget {
  final String appName = 'Your New App Name'; // Use the updated app name

  Widget build(BuildContext context) {
    return MaterialApp(
      title: appName, // Use the app name in the MaterialApp widget
      home: Scaffold(
        appBar: AppBar(
          title: Text(appName), // Display the app name in the app bar
        body: Center(
          child: Text('Welcome to $appName!'), // Use the app name in UI

By using the updated app name within your code, you ensure that the changes you made are reflected in the user interface of your app.

Step 2: Updating the App Icon in Flutter

In this section, we’ll delve into the process of updating the app icon in your Flutter project. App icons are more than just visual elements; they serve as a recognizable symbol that represents your app and can greatly influence user recognition. Let’s explore the importance of app icons and then proceed to the practical steps of updating them.

1. Importance of App Icons

App icons are the face of your application. They are the first visual element users encounter when they see your app on their devices. A well-designed app icon can leave a lasting impression and contribute to the overall user experience. Icons act as a quick identifier, making it easier for users to locate your app among a sea of other apps. They play a crucial role in establishing your app’s visual identity and conveying its purpose even before the app is launched.

2. Locating the App Icon in Flutter

The app icon is typically defined as an asset in the pubspec.yaml file of your Flutter project. Here’s how you can find it:

  • Open your Flutter project in your chosen code editor.
  • Navigate to the root directory of your project.
  • Locate and open the pubspec.yaml file.

3. Replacing the App Icon in Flutter

To replace the default app icon with a custom one, follow these steps:

  • Prepare the new app icon image in the required dimensions (e.g., 512×512 pixels).
  • Place the app icon image file in the assets folder of your Flutter project.

In the pubspec.yaml file, add the following lines to specify the app icon:

    - assets/app_icon.png

Replace assets/app_icon.png with the actual path to your app icon image.

4. Generating App Icons in Flutter

To generate app icons for different screen resolutions and platforms, you can use tools like Flutter Launcher Icons. This tool automates the process of generating icons in various sizes and formats, ensuring that your app icon looks sharp and consistent across different devices.

To use Flutter Launcher Icons, follow these steps:

  • Install the flutter_launcher_icons package by adding it to the dev_dependencies section of your pubspec.yaml file.
  • Configure the flutter_icons section in your pubspec.yaml file with the paths to your icon image and desired output paths for the generated icons.
  • Run the command flutter pub run flutter_launcher_icons:main to generate the icons.

By utilizing tools like Flutter Launcher Icons, you can save time and effort while ensuring that your app icons are optimized for various screen sizes and resolutions.

Step 3: Adapting for iOS and Android

As we venture further into customizing your Flutter app’s identity, it’s essential to consider the nuances between iOS and Android platforms. Each platform has its own set of guidelines for app naming and icons, and understanding these differences is crucial for a polished and consistent user experience. Let’s explore the distinctions between the two platforms and learn how to adapt your app for each.

1. Differences Between Platforms

iOS and Android have distinct design languages and user interface conventions. These differences extend to app naming and icons, where each platform has its own guidelines. While Android icons often lean towards material design with vibrant colors and bold shapes, iOS icons tend to be more minimalistic and sleek. Recognizing and embracing these differences ensures that your app feels native and intuitive on each platform.

2. Platform-Specific Configuration

To configure platform-specific names and icons, you can utilize the flutter section in your pubspec.yaml file. By providing platform-specific entries, you can ensure that your app adapts gracefully to the conventions of each platform.

3. Handling iOS Icons in Flutter

iOS icons have specific size and format requirements. The following icon sizes are commonly used:

  • 1024×1024 pixels (App Store icon)
  • 180×180 pixels (iPhone 6 Plus and later)
  • 152×152 pixels (iPad)
  • 120×120 pixels (iPhone and iPad Retina)
  • 76×76 pixels (iPad)
  • 60×60 pixels (iPhone)

Ensure that you create your icons in these sizes and formats to ensure optimal display on iOS devices. You can then specify these icons in your pubspec.yaml file using the flutter section.

4. Adapting to Android

Android introduces the concept of adaptive icons, which consist of a foreground and a background layer. The foreground can be designed to accommodate different shapes, while the background provides a consistent background layer. This allows your app icon to adapt seamlessly to various device-specific shapes.

To create adaptive icons, you need to prepare different layers for the foreground and background, and then configure them in your pubspec.yaml file. The adaptive icon format ensures that your app’s icon retains its visual appeal across a variety of Android devices.

Step 4: Testing the Changes

Now that you’ve made adjustments to your app’s name and icon, it’s time to test your changes and ensure that your app’s identity transformation is reflected accurately on both iOS and Android platforms.

1. Running the App

To test your app, follow these steps:

  • Open your terminal or command prompt.
  • Navigate to your Flutter project directory using the cd command.
  • Run the command flutter run to launch your app on the default emulator or simulator.

Your app should launch on both iOS and Android simulators/emulators, allowing you to see how your changes appear in each environment.

2. Verifying App Name in Flutter

Upon launching your app, pay close attention to the app’s name that appears in the app drawer or home screen. Ensure that the updated app name you configured in the pubspec.yaml file is accurately displayed.

3. Ensuring App Icon Update

Similarly, examine the app icon displayed on both iOS and Android devices. Confirm that the new custom icon you added to the assets folder is being used as the app’s icon. Check for any inconsistencies or unexpected behavior in the icon’s appearance.

By thoroughly testing your app’s name and icon changes on both platforms, you can identify any issues and make necessary adjustments to ensure a seamless user experience.

In the next section, we’ll delve into best practices and tips for app branding and customization, helping you create an app that not only looks great but also resonates with your target audience.

Step 5: Best Practices and Tips

As you continue to refine your app’s identity, it’s essential to follow best practices and consider valuable tips that can elevate the impact of your branding efforts. Let’s explore some key aspects to keep in mind as you work on your app’s name and icon customization.

1. Consistency in Branding

Maintaining consistent branding across different platforms is crucial. Your app’s name, icon, colors, and overall visual identity should align seamlessly to create a unified and recognizable user experience. Consistency reinforces your app’s identity and makes it easier for users to associate your app with its purpose.

2. Choosing App Names

When selecting an app name, opt for something memorable, relevant, and reflective of your app’s functionality. Keep it concise, avoiding overly complex or ambiguous names. Conduct thorough research to ensure that the chosen name is unique and not already in use by other apps.

3. Designing App Icons

When designing your app icon, consider these guidelines:

  • Simplicity: A clean and simple design tends to be more effective and memorable.
  • Relevance: The icon should hint at the app’s purpose, allowing users to understand its functionality at a glance.
  • Scalability: Ensure the icon looks appealing and remains recognizable in various sizes.
  • Consistency: Align the icon’s style with your overall branding for a cohesive visual identity.

4. Version Control Considerations

As you make changes to your app’s name and icon, consider using version control systems like Git. Version control allows you to track changes, collaborate with other developers, and revert to previous states if needed. This ensures that you have a clear history of changes and can manage your app’s updates effectively.

By following these best practices and tips, you can create an app that not only looks great but also resonates with users and establishes a lasting presence in the competitive app market.

Step 6: Troubleshooting

While customizing your app’s name and icon can be a rewarding process, you might encounter some challenges along the way. Let’s explore common troubleshooting scenarios and solutions to help you address potential issues.

1. App Name Not Updating

If you find that your updated app name isn’t appearing as expected, consider these solutions:

  • Clearing Cache: Sometimes, the app cache might prevent the updated name from displaying. Try clearing the cache on your emulator or device and relaunching the app.
  • Hot Reload or Restart: Use the hot reload or restart feature in Flutter to force the app to update with the latest changes.
  • Check Flutter Version: Ensure that you’re using a compatible version of Flutter. Outdated versions might exhibit unexpected behavior.

2. Incorrect App Icon

If your app icon doesn’t change or appears incorrectly, follow these troubleshooting steps:

  • Asset Path: Verify that the path to your new app icon image in the pubspec.yaml file is accurate.
  • Clear Build Cache: Sometimes, cached builds can cause icon issues. Run the command flutter clean to clear the build cache and rebuild the app.
  • Icon Format: Ensure that your icon image is in the correct format (e.g., PNG) and follows the recommended size guidelines for different platforms.

By systematically troubleshooting these issues, you can identify the root causes and implement effective solutions to ensure that your app’s name and icon changes are reflected accurately.


So there you have it! We’ve journeyed through the exciting world of customizing your app’s name and icon. Remember, it’s not just about appearances – it’s about making a strong connection with your users. With Flutter’s magic, you can give your app a unique touch that sets it apart. So, go ahead, get creative, and let your app’s personality shine. Happy customizing!


To change the app name and icon in a Flutter app, you can follow these official references:

  1. Flutter’s official documentation provides guidance on building Flutter apps for the web and Android. You can modify the app icon by updating the AndroidManifest.xml file with the desired icon reference. Reference:
  2. For changing the app icon, check out this GeeksforGeeks guide that explains how to manually change icons in both Android and iOS folders. Reference:
  3. You can easily change the default Flutter app icon using Flutter-supported platforms. Learn more about changing the app launcher icon with practical examples from this Medium article. Reference:
  4. The flutter_launcher_icons package offers a command-line tool to update your Flutter app’s launcher icon. This package provides flexibility to choose icons for different platforms. Reference:
  5. You can check more information and stuff on app name and icon here

Frequently Asked Questions

Can I change the app name and icon after the app is published?

Yes, you can change the app name and icon even after your app has been published. However, it’s important to consider a few factors before making these changes. If your app has already gained a user base, sudden changes to the app name or icon might confuse existing users. Additionally, app stores have their own guidelines and approval processes for updated app submissions. It’s recommended to communicate the changes clearly to users and plan the transition carefully to minimize any potential disruption.

Do app name and icon changes affect app performance?

No, changing the app name and icon does not directly impact the performance of your app. These changes are cosmetic and mainly influence the visual and branding aspects of your app. The core functionality and performance of your app remain unaffected by such changes.

Are there any size or format requirements for app icons?

Yes, app icons have specific size and format requirements for different platforms. For iOS, icons should be provided in various sizes, including 1024×1024 pixels for the App Store and various sizes for devices. Android uses adaptive icons, which consist of a foreground and background layer. The foreground should be provided in various shapes and sizes, while the background remains consistent. Refer to the official documentation for each platform to ensure that you adhere to the recommended specifications.

Can I use animated icons?

While the idea of animated icons is intriguing, using them comes with some challenges. Animated icons might increase the app’s file size, potentially impacting download times and storage usage. Additionally, not all platforms and devices support animated icons universally. If you’re considering animated icons, carefully assess their impact on user experience and performance, and ensure that they enhance the app’s functionality without compromising its usability.

Is there a specific reason to change the app name and icon in Flutter?

Absolutely, changing the app name and icon in Flutter can bring several benefits. It allows you to refresh your app’s identity, align it with rebranding efforts, and make a strong visual impact on users. Moreover, a well-chosen name and a distinctive icon can set your app apart in the crowded app market, enhancing recognition and user engagement.

Does changing the app name affect the functionality of the app?

No, changing the app name doesn’t affect the functionality of the app. It’s primarily a cosmetic change that influences the way users perceive and remember your app. The core functionality and behavior of your app remain unchanged, ensuring a seamless user experience despite the name change.

What’s the role of branding when it comes to app names and icons?

Branding plays a significant role when it comes to app names and icons. It’s all about creating a unique identity and fostering a connection with your users. A well-defined brand identity through your app’s name and icon helps users recognize and remember your app more easily. It sets the tone for what your app offers and the value it brings, making a lasting impression and encouraging user engagement.

How can I locate the pubspec.yaml file to change the app name in Flutter?

To locate the pubspec.yaml file and change the app name in Flutter, you’ll need to navigate to the root directory of your Flutter project. The pubspec.yaml file contains essential project information, including the app’s name. Open the file using a text editor or integrated development environment (IDE) and look for the name field. Here, you can update the app’s name to your desired choice, and these changes will be reflected in your app’s identity.

What if I want to revert back to the previous app name? Is that possible?

Absolutely, reverting back to the previous app name is possible in Flutter. If you’ve made changes to the app name in the pubspec.yaml file and later decide to return to the previous name, you can simply edit the name field in the pubspec.yaml file again and replace it with the original app name. Save the file, and your app will revert back to its previous name. Remember, these changes take effect when you rebuild or run your app.

Can I change the app’s name programmatically within the app’s code?

Yes, you can change the app’s name programmatically within the app’s code, but it’s important to note that this change would be limited to how your app refers to itself within its user interface. The actual app name displayed on the user’s device, app store, and other places is defined in the pubspec.yaml file and can’t be changed programmatically at runtime. However, you can use the app name defined in the pubspec.yaml file within your app’s code to ensure consistency and dynamic referencing.

What are some best practices for choosing a memorable app name?

Choosing a memorable app name involves a few key best practices:
Relevance: Choose a name that reflects your app’s purpose.
Simplicity: Opt for an easy-to-pronounce and concise name.
Uniqueness: Ensure the name stands out and isn’t already used.
Memorability: Pick a catchy name that’s easy to remember.
Keywords: Include relevant keywords for better discoverability.
Feedback: Get user input to gauge name preferences.

Are there any legal considerations when changing the app name?

Yes, there are legal considerations when changing the app name. It’s important to ensure that the new name doesn’t infringe upon existing trademarks or copyrights held by other entities. Conduct thorough research to make sure the new name is unique and doesn’t create confusion with other apps or brands. Additionally, consider any contractual obligations, terms of service, or agreements related to your app’s name. Consulting legal experts can provide guidance and help you navigate potential legal issues when renaming your app.

What’s the significance of app icons in Flutter apps?

App icons in Flutter apps hold significant importance as they serve as visual representations of your app. They’re the first thing users see before even launching your app. An eye-catching and well-designed icon creates a positive first impression, enhancing user recognition and encouraging them to engage with your app. A thoughtfully crafted icon contributes to your app’s overall brand identity and plays a role in shaping user perception.

Can I change the app icon without affecting the app’s functionality?

Absolutely, changing the app icon in Flutter doesn’t impact the app’s functionality. It’s a cosmetic update that influences only the visual representation of your app. Users can interact with the app’s features and functions as they did before. This flexibility allows you to refresh your app’s look without worrying about disrupting its core functionality or user experience.

What are adaptive icons, and how do they work in Flutter?

Adaptive icons are a concept specific to Android that Flutter accommodates. They consist of a foreground and background layer. The foreground holds the app’s logo or symbol, while the background provides a consistent shape. In Flutter, you can use the flutter_launcher_icons package to create adaptive icons. By using this package, you can generate adaptive icons in various shapes and sizes, ensuring your app maintains a cohesive appearance across different Android devices and versions.

What happens if I don’t update my app’s icon for different resolutions?

If you don’t update your app’s icon for different resolutions, the icon might appear pixelated or stretched on devices with varying screen sizes and resolutions. This can lead to a less-than-optimal user experience, as the icon won’t look crisp and clear. By providing icons in different resolutions, you ensure that your app’s visual elements, including the icon, maintain their quality and integrity across a wide range of devices, enhancing the overall appeal of your app.

Are there tools available to generate app icons for Flutter apps?

Yes, indeed! There are tools available to simplify the process of generating app icons for Flutter apps. One such tool is the “Flutter Launcher Icons” package, which automates the creation of icons for various screen resolutions and device sizes. This package generates icons from a single source image, saving you time and effort. By using tools like these, you can ensure that your app icons are consistent, high-quality, and tailored to different platform requirements.

Can I have different app icons for different versions of my Flutter app?

Yes, you can indeed have different app icons for different versions of your Flutter app. By updating the icon paths in the pubspec.yaml file for each version and utilizing conditional statements in your code, you can dynamically set different icons based on specific app versions. This enables you to tailor the app’s visual identity to different releases, enhancing user experience and branding consistency across updates.

5/5 (1 vote)
Share to:


Scroll to Top