MSIX app icon sizes for the Microsoft Store

What the manifest points to

These are the logo entries in an MSIX manifest. The number in each name is its base size. Windows asks for a bigger version on high-resolution screens, so you also ship copies at higher scales. Microsoft suggests at least 100%, 200% and 400% for Square44x44Logo and Square150x150Logo. Windows uses the closest one for the scales in between.

Sizes are in pixels and square unless two numbers are given. Microsoft's table also lists 125%, 150%, 250% and 300%. Windows 11 doesn't show tiles, but Microsoft says the medium tile at 100% is still required to publish to the Store.

In the manifest, the entries look like this. The paths point to the base file name, without a scale.

<Properties>
  <DisplayName>My App</DisplayName>
  <PublisherDisplayName>My Name</PublisherDisplayName>
  <Logo>Assets\StoreLogo.png</Logo>
</Properties>
...
<uap:VisualElements
  DisplayName="My App"
  Description="What my app does"
  BackgroundColor="transparent"
  Square150x150Logo="Assets\Square150x150Logo.png"
  Square44x44Logo="Assets\Square44x44Logo.png">
  <uap:DefaultTile Wide310x150Logo="Assets\Wide310x150Logo.png" />
  <uap:SplashScreen Image="Assets\SplashScreen.png" />
</uap:VisualElements>

The app icon's target sizes

Square44x44Logo is the icon people see most: on the taskbar, in Start, in search and in the title bar. Here Windows uses exact pixel sizes instead of scales. Microsoft says apps should have at least 16, 24, 32, 48 and 256, so Windows only ever scales the icon down. Its full list is 16, 20, 24, 30, 32, 36, 40, 48, 60, 64, 72, 80, 96 and 256.

Each size comes in three versions, told apart by the file name.

Microsoft says that without the unplated files, your icon shrinks and gets a backplate behind it on the taskbar and Start. That colored square usually means the unplated files are missing.

What the Assets folder ends up holding

A trimmed example for the app icon and the medium tile:

Assets\
  Square44x44Logo.png
  Square44x44Logo.scale-200.png
  Square44x44Logo.scale-400.png
  Square44x44Logo.targetsize-16.png
  Square44x44Logo.targetsize-16_altform-unplated.png
  Square44x44Logo.targetsize-16_altform-lightunplated.png
  ... (the same three for 24, 32, 48, 256 and the other sizes)
  Square150x150Logo.png
  Square150x150Logo.scale-200.png
  Square150x150Logo.scale-400.png
  StoreLogo.png
  StoreLogo.scale-200.png
  StoreLogo.scale-400.png

If you write the manifest yourself and pack with MakeAppx, there's one more file. Microsoft says that when you add target-size assets or change the visual assets, you have to generate a new package resource index, resources.pri, with MakePri from the Windows SDK. Run these in the folder you're about to pack:

makepri.exe createconfig /cf priconfig.xml /dq en-US
makepri.exe new /pr C:\MyApp /cf C:\MyApp\priconfig.xml

Make them all from one image

Microsoft's winapp CLI has a command for this. Point it at one image and it writes every logo the manifest names into the Assets folder next to the manifest.

winapp manifest update-assets mylogo.png
winapp manifest update-assets mylogo.png --light-image mylogo-light.png

Microsoft's reference says it makes five scale versions of each manifest asset (100, 125, 150, 200 and 400), 14 plated and 14 unplated target sizes for the app icon, and an app.ico with 16, 24, 32, 48 and 256. With --light-image it adds the light theme versions too. winapp is in public preview, so check its docs if a command changes.

Electron, Flutter, Tauri and the other frameworks each set icons in their own way. The first app guide links the guide for each.

Checks before you submit

• Use a transparent background. Microsoft says icons look best that way. A plated icon needs its own light and dark versions to look right in both themes.
• Replace every placeholder. Templates and AI-generated projects often ship a default logo in the Assets folder, and it shows up in Start and on the taskbar.
• Run the Windows App Certification Kit before you submit. Microsoft says it finds images your package is missing. Our submission checklist has the command.
• Upload a 300 x 300 app tile icon in your Store listing as well. Microsoft strongly recommends it, and the Store uses it instead of the package image. Our screenshot sizes guide covers the listing images.
• Install the package and look at the icons. Our guide to installing an MSIX shows how to try it on your own PC.

StoreFast and icons

StoreFast doesn't make icons. Once your app is in the Store, it publishes each new .msix you drop on the page, checks its name and version before upload and writes What's new in every listing language. If you change your icons, they go out in the next package like any other change.

Questions

What icon sizes does a Windows app need?

Microsoft says every app should have at least 16 x 16, 24 x 24, 32 x 32, 48 x 48 and 256 x 256. In an MSIX, those are the target-size versions of the app icon (Square44x44Logo). The package also needs a Store logo and a medium tile, each with versions for different display scales.

Which icons are required to publish to the Microsoft Store?

Microsoft's icon page says the package logo (StoreLogo) is required, and that the medium tile at 100% scale is currently required to publish even though Windows 11 doesn't show tiles. It also marks the app icon's target-size files as required. Run the Windows App Certification Kit to find any that are missing.

Why does my app icon have a colored square behind it on the taskbar?

Windows puts the icon on a plate when it can't find the unplated versions. Add the targetsize files with _altform-unplated in the name, and for the light theme, _altform-lightunplated.

Is the Store listing icon the same as the package icon?

No. In the Store listing you can upload a 1:1 app tile icon of 300 x 300. Microsoft strongly recommends it, and if you upload one, the Store uses it instead of the image in your package.