HarmonyOS App Icon Sizes & Design Guide

Everything you need to know about HarmonyOS (鸿蒙) app icon sizes, design guidelines, and Huawei AppGallery submission requirements. Updated for 2026.

Last updated: May 2026 · 7 min read

HarmonyOS (鸿蒙) has rapidly grown into one of the world's largest mobile operating systems. With hundreds of millions of devices spanning smartphones, tablets, smart TVs, wearables, and IoT hardware, the HarmonyOS ecosystem represents a significant opportunity for app developers. Huawei's AppGallery is the primary distribution channel for HarmonyOS apps, and meeting its icon requirements is essential for a successful listing.

Unlike Android and iOS, HarmonyOS has its own unique icon sizing requirements and design conventions. This guide covers every size you need, the design principles that make HarmonyOS icons look native, and the AppGallery submission rules you must follow.

Required HarmonyOS App Icon Sizes

HarmonyOS defines several icon sizes for different contexts, from the small notification icons to the high-resolution assets used on the AppGallery listing page. Each size serves a specific purpose within the operating system's UI.

ContextSize (px)Usage
Small48 x 48Notification bar, status indicators
Medium72 x 72App drawer grid view, shortcuts
Large96 x 96Home screen launcher, recent apps
Extra Large144 x 144Tablet and large-screen launchers
Launcher192 x 192High-density device launcher icon
AppGallery216 x 216AppGallery search results and category listings
Large AppGallery512 x 512AppGallery app detail page, featured banners

For best results, start with a source image of at least 512 x 512 pixels. This ensures that downsampling to smaller sizes produces crisp, clean results at every resolution HarmonyOS uses.

HarmonyOS Icon Design Guidelines

HarmonyOS follows a design philosophy centered on clarity, simplicity, and visual harmony. Icons should feel at home on Huawei devices, which typically feature rounded corners and a clean, modern aesthetic. Here are the key design principles:

  • Rounded corners— HarmonyOS applies a consistent rounded-corner mask to all app icons. Design your icon as a full square image without adding your own rounded corners; the system handles the shape automatically.
  • Consistent visual style— Use a consistent color palette and visual language that matches your app's brand. Avoid photographic imagery; flat or semi-flat illustrations work best at small sizes.
  • Clear silhouette— The main subject of your icon should be instantly recognizable. Avoid excessive detail that becomes muddy when scaled down to 48 px.
  • Safe zone padding— Keep critical design elements within the center 80% of the icon area. The outer edges may be clipped by the system's rounded-corner mask.
  • No text or badges— Do not include text, version numbers, or promotional badges in the icon artwork. Text is generally unreadable at small icon sizes and clutters the design.
  • High contrast background— Use a solid or gradient background with sufficient contrast against the foreground element. Avoid transparent backgrounds.

Design tip

Test your icon at the smallest size (48 x 48 px) first. If the main shape is still recognizable and the colors are distinct, the icon will work well at all sizes. Many designers make the mistake of only reviewing the 512 px version and are surprised by how much detail is lost at smaller sizes.

AppGallery Submission Requirements

When submitting your app to Huawei AppGallery, you must provide icon assets that meet specific technical and content requirements. Failing to meet these requirements is one of the most common reasons for submission rejection.

RequirementSpecification
Small icon216 x 216 px, PNG
Large icon512 x 512 px, PNG
FormatPNG, 32-bit with alpha
ShapeFull square (system applies rounded mask)
BackgroundOpaque (no transparency in background)
ContentMust match the in-app launcher icon design

Common rejection reasons

  • Icon does not match the app's actual launcher icon.
  • Icon contains promotional text, pricing, or “free” badges.
  • Using another app's icon or a close imitation of a well-known brand.
  • Icon resolution is too low or the image is visibly pixelated at the required size.
  • Transparent or semi-transparent background that does not render correctly with the system mask.

How to Generate HarmonyOS App Icons

Instead of manually resizing your icon for every HarmonyOS context, use IconForge to generate all required sizes in one step. The entire process runs in your browser — your image is never uploaded to any server.

1

Upload your source image

Drag and drop or browse to select a PNG, JPG, or SVG file. For best results, provide a square image of at least 512 x 512 pixels to ensure all output sizes are crisp.

2

Select HarmonyOS as target

Choose the HarmonyOS platform to generate icons for all required sizes: 48 px, 72 px, 96 px, 144 px, 192 px, 216 px, and 512 px in a single batch.

3

Download and integrate

Download the complete icon pack as a ZIP file. Each icon is named according to its size and context, ready to be placed into your HarmonyOS project. Upload the 216 px and 512 px versions to AppGallery when submitting your app.

Generate Your HarmonyOS Icons Now

Free, no login required. Upload one image and get all HarmonyOS icon sizes in seconds. 100% client-side — your image never leaves your device.

Open HarmonyOS Icon Generator

Frequently Asked Questions

Are HarmonyOS icon sizes different from Android?

Yes. While there is some overlap (both platforms use 48 px, 72 px, and 192 px in certain contexts), HarmonyOS has its own set of required sizes, including 216 px and 96 px variants that Android does not use. Always generate platform-specific assets rather than reusing Android icons.

Should I add rounded corners to my HarmonyOS icon?

No. Submit your icon as a full square image. HarmonyOS applies a uniform rounded-corner mask across all app icons on the device and in AppGallery. Adding your own rounded corners can cause visual inconsistencies and may lead to submission rejection.

Can I use the same icon for HarmonyOS and Android?

You can use the same source design, but you should generate separate icon sets for each platform. The required sizes differ, and each platform has its own masking and safe zone conventions. IconForge supports iOS, Android, and HarmonyOS so you can generate for all three platforms from a single upload.