How to add an app to the main screen of Xiaomi: all ways + error solving

Did you install a new app on a Xiaomi smartphone but its icon didn't appear on the home screen? Or did all the shortcuts disappear after the MIUI update? This problem is familiar to many owners of Redmi, POCO and Black Shark devices. Unlike "pure" Android, the MIUI shell has its own nuances of working with the desktop - there is no classic "app menu" and automatic icon placement algorithms are often confusing.

In this article, we will look at 5 proven ways to add an app to Xiaomi’s home screen, from basic to hidden features for power users, and focus on MIUI 14/15 solutions where the logic of working with shortcuts has changed compared to previous versions, and learn why icons can disappear on their own and how to prevent it.

1. Standard method: via the application menu

The most obvious method is to use the built-in All Apps menu, which works on all Xiaomi models, including the Redmi Note 12, POCO X5 and Xiaomi 13T. Here is a step-by-step guide:

  1. Swipe your finger up from the bottom edge of the screen to open the app menu (on some firmwares, you need to click on the dot at the bottom of the screen).
  2. Find the app you want in the list. If it's not there, check the tab recently installed or search (the magnifier at the top of the screen).
  3. Press the app icon for 1-2 seconds until the context menu appears.
  4. Select Add to the main screen (or drag the icon to the free space).

⚠️ Attention: If you press the icon for a long time, it just opens and the menu does not appear, then you have One-Handed Mode on or Navigation Gestures conflict with the system. β†’ Additionally. β†’ Special facilities.

β˜‘οΈ Check before adding an icon

Done: 0 / 4

On some firmware (e.g. MIUI 14 Global), a bug may be triggered after the update when icons are added but not displayed.

  1. Restart the device (press the power button β†’ Reboot).
  2. If it didn’t help, clear the launcher cache: Settings β†’ Applications β†’ Application Management β†’ Launcher β†’ Storage β†’ Clear the cache.

2. Alternative method: through launcher settings

If the standard method didn’t work, try configuring the display of icons through the launcher settings, a method that is especially useful for users of POCO Launcher or MIUI Launcher with customized themes.

Instructions:

  1. Click the empty space on the home screen β†’ select Screen Settings (or Launcher Settings).
  2. Go to the Application Settings section β†’ Hidden applications.
  3. Make sure the app is not hidden. If it's on the list, uncheck the box.
  4. Return to Screen Settings β†’ Home Screen layout and select Standard (if installed Without shortcuts).

⚠️ Attention: On some firmware (MIUI 15 China) The launcher settings may not be available. In this case, use the developer mode:

Settings β†’ About Phone β†’ MIUI version (click 7 times)


Settings β†’ Additional β†’ For developers β†’ Enable β€œDebugging by USB” and β€œAllow changing system settings”

What to do if there is no item "Start-up settings"
If you're in your version MIUI There's no launcher settings section, which means the launcher has blocked access to them: 1. Install a third-party launcher (Nova Launcher, Apex Launcher). 2. Use it. ADB-Unlock hidden settings: adb shell settings put global hidden_api_policy 1 Warning: misuse ADB It could cause system failures!

Addition via the "Application shortcuts" widget

Few people know, but MIUI has a hidden widget that allows you to add app icons to the home screen, bypassing the standard menu, which works even if the app doesn’t appear in the All Apps list.

How to do this:

  1. Click the empty space on the home screen β†’ select Widgets.
  2. Scroll down and find the App Shortcuts widget (or App Shortcuts on English firmware).
  3. Drag the widget to the home screen, and you'll see a list of all the apps you've installed.
  4. Select the desired application – its icon will appear on the screen.

The advantage of this method is:

  • πŸ”Ή It works even for system applications that are usually hidden (e.g. Hardware Tests or Developer Mode).
  • πŸ”Ή Allows you to add duplicate icons (useful for frequently used applications).
  • πŸ”Ή Bypasses the limitations of some design themes that block the addition of shortcuts.

πŸ’‘

If the App Shortcuts widget is not listed, try resetting the launcher settings: Settings β†’ Apps β†’ Application Management β†’ Launcher β†’ Storage β†’ Clear Data. Attention: This will delete all your folders and icon locations on the home screen!

4.Use of ADB to force icons to be added

For advanced users who are not afraid of the command line, there is a way to add an icon to the home screen through ADB (Android Debug Bridge).

  • πŸ”§ The application does not appear in the menu "All applications".
  • πŸ”§ Launcher blocks the addition of shortcuts (for example, in corporate firmware).
  • πŸ”§ Automation of the process for several devices.

Instructions:

  1. Install ADB Tools on your computer and connect your phone over USB (don’t forget to enable USB debugging in the developer settings).
  2. Open the command line (Windows) or terminal (macOS/Linux) and type in: adb shell am start -a android.intent.action.MAIN -n com.miui.home/.launcher.UninstallShortcutPreview
  3. The phone will show a list of all the apps on the screen, and you can choose which one you want, and the icon will be added to the home screen.

To add a specific application (if you know its package), use the command:

adb shell am start -a android.intent.action.CREATE_SHORTCUT -n com.android.launcher3/.ShortcutInstallActivity -d "package:name packet" -e "duplicate" "false"
ADB Team TeamDescriptionWhen to use
adb shell pm list packagesShows a list of all installed packagesTo find the name of the package of the desired application
adb shell am start -n com.miui.home/.launcher.UninstallShortcutPreviewOpens the menu of adding labelsIf the standard methods do not work
adb shell settings put global hidden_api_policy 1Unlocks Hidden APIsTo access hidden launcher settings
πŸ“Š What is the way you add icons more often?
Standard (via the application menu)
Through the tag widget.
ADB-team
Sideways launcher
Another option

5. Solving the Problem: Why Icons Are Disappearing or Not Added

One of the most common problems with Xiaomi is the spontaneous disappearance of icons from the home screen, which can occur for several reasons:

  • πŸ”„ Auto-cleaning: B MIUI There's a Memory Cleanup feature that can remove unused shortcuts. Turn it off in Settings. β†’ Battery and productivity β†’ Cleaning up memory β†’ Settings β†’ Deactivate "Clear labels".
  • 🎨 Reset themes: When changing the theme, some launchers reset the location of the icons. Before changing the theme, back up the screen layout.
  • πŸ”§ Launcher conflict: If you have a third-party launcher installed (like Nova), but default is MIUI Launcher, icons may disappear when switching between them.
  • πŸ“± Firmware update: After major updates (e.g., with MIUI 14 on MIUI 15) the system may reset the screen settings.

⚠️ Note: If the icons disappear after the device is restarted, this may indicate damage to the launcher data:

  1. Go to Settings β†’ Applications β†’ Application Management β†’ Launcher β†’ Storage.
  2. Click Clear Data (not cache!).
  3. Restart the device – the icons must be restored.

πŸ’‘

If icons are only missing for specific apps (like Google Play or banking apps), check if they are hidden in the security settings: Settings β†’ Privacy β†’ Special Access β†’ Hidden Apps

6.Side Launchers: Alternative to the Standard MIUI Launcher

If the built-in methods don't suit, you can install a third-party launcher that offers more flexibility in setting up the home screen.

LauncherAdvantagesDeficiencies
Nova LauncherFlexible gesture setting, icon pack support, layout backupPremium version for some functions
POCO LauncherOptimized for Xiaomi, lightweight, built-in memory cleanupLess customization options than Nova
Microsoft LauncherWindows integration, PC sync, minimalist designCan brake on weak devices (Redmi 9A, POCO M3)
Hyperion LauncherSupport for dynamic wallpaper, adaptive icons, built-in theme editorHigh battery consumption

How to install a third-party launcher:

  1. Download the launcher from Google Play (or APK-file).
  2. After installation, click the Home button - the system will prompt you to choose the default launcher.
  3. Select a new launcher and confirm the choice.

⚠️ Note: On some Xiaomi firmware (especially Chinese) third-party launchers may not work smoothly due to restrictions MIUI. If after installation the launcher is constantly reset to the standard, perform:

Settings β†’ Applications β†’ Application Management β†’ [Your Launcher] β†’ Battery β†’ Without Limitations


Settings β†’ Additional β†’ For developers β†’ Disable "Optimization MIUI"

7. Features for different Xiaomi models

The logic of adding icons may vary depending on the device model and firmware version, and below are the key nuances for popular lines:

  • πŸ“± Redmi Note 11/12/13: These models have no shortcuts enabled by default, and to return the icons, press the main screen. β†’ Screen settings β†’ Main screen layout β†’ Choose Standard.
  • πŸ“± POCO F4/F5: It's used here. POCO Launcher, which automatically sorts apps into categories.To disable this: Launcher settings β†’ Categories of applications β†’ Shut down.
  • πŸ“± Xiaomi 13/14 Ultra: On flagships with MIUI 15 Added Desktop Mode that simulates PC-In this mode, icons are added through the Taskbar (swipe up from the bottom edge).
  • πŸ“± Black Shark 5/6: On gaming smartphones, shortcuts are added via Game Dock.Clutch the icon in the dock and drag to the main screen.

For devices with MIUI for Russia (e.g. Redmi 10C or POCO M5), additional configuration may be required due to the limitations of Google Mobile Services (GMS).

  1. Install the latest version of Google Play Services from the store.
  2. Clear the Settings cache β†’ Apps β†’ Google Play Services β†’ Storage β†’ Clear the cache.
  3. Reset the device.

πŸ’‘

On devices with MIUI China Stable (such as imported Xiaomi 14 Pros), Google Installer (GApps) is required to pre-installe Google App icons to add Google App icons.

FAQ: Frequent questions about shortcuts on Xiaomi

Can I add a system application icon (e.g., Equipment Tests) to the home screen?
Yes, but it's not possible to do this with standard methods. Use one of the ways: Through the app shortcut widget (section) 3 Articles) By means of ADB-team (section) 4). Install a launcher with support for hidden applications (for example, Nova Launcher). For the application Hardware Tests (com.android.cts.ctsshim), use the command: adb shell am start -a android.intent.action.CREATE_SHORTCUT -n com.android.launcher3/.ShortcutInstallActivity -d "package:com.android.cts.ctsshim"
Why did all the icons from the main screen disappear after the MIUI update?
This is a known problem when switching to a new firmware version. Solutions: Reboot the device β€” sometimes icons are restored automatically. Clear the launcher cache: Settings β†’ Applications β†’ Launcher β†’ Warehouse β†’ Clear the cache. If it didn't work, reset the launcher settings (but this will remove all folders and icon locations!). For MIUI 15: check if Desktop Mode is turned on (swipe up from the bottom edge β†’ click on the gear β†’ select Standard Mode).
How to add a website icon to the home screen (like Chrome)?
In Google Chrome or Mi Browser: Open the right site. Click on the top right corner β†’ Add to the main screen. Confirm the addition, the icon will appear on the desktop. If the item is missing: Update your browser to the latest version. In Mi Browser, enable the function: Settings β†’ Additional β†’ Add shortcuts to the main screen.
Can I create a folder with apps on the Xiaomi home screen?
Yes, for this: Drag one icon to another and hold for 1-2 seconds. Let go, a folder with an automatic name (like "Games" or "Social Networks") will be created. To rename a folder, open it and tap it on the name at the top. Some firmwares create folders differently: Press the icon β†’ Create a folder. Or use the app folder widget (in the widget list).
How to return the standard view of the main screen after reset?
If after cleaning the launcher data or resetting the settings, the icons are scattered chaoticly, restore the standard layout: Click the empty space on the screen β†’ Screen settings. Select Restore Default Layout (or Reset Screen Settings). Confirm action, icons will return to their original position. If this is not available: Set a standard design theme: Settings β†’ Topics β†’ My subjects. β†’ Reset the device, reset the device.