[iOS] Custom App Icon still renders as white square after fixing accentColor and validating icons

Question

[iOS] Custom App Icon still renders as white square after fixing accentColor and validating icons

Xianyun Tang 25

I am following up on a rendering issue where my custom app icon appears as a blank white square on the iOS client.

Current Status:

User's image

Despite following the standard guidelines, the icon fails to render on iOS (Works perfectly on Android/Desktop).

What I have tried (and failed):

Changed accentColor: Updated manifest from #FFFFFF to #4B6BF5 (Brand Blue) to avoid white-on-white issues.
Version Bump: Increased manifest version from 1.0.17 to 1.0.18 to force cache invalidation.
Re-installation: Completely uninstalled the app on iOS, cleared app data, and re-added it.

Icon Validation:

color

color.png: 192x192, PNG, Transparent background.

outline

outline.png: 32x32, PNG, Pure white pixels only with transparent background.

Manifest Snippet:

{
  "version": "1.0.18",
  "manifestVersion": "1.22",
  "id": "<Removed PII>",
  "icons": {
    "outline": "outline.png",
    "color": "color.png"
  },
  "accentColor": "#4B6BF5"
}

Questions & Request for Assistance:

Has anyone faced a similar "blank white square" issue on iOS recently? Any suggestions would be greatly appreciated.

Todd Wang 0 Reputation points

2026-01-16T04:41:32.14+00:00

Hi, @唐宪云
These days, I have been uploading a Teams app and noticed issues with the iOS system. Currently, it has been found that icons cannot be displayed on iOS 18.7 and above, including the newly released iOS 26. May I ask which version of iOS you are having issues with?
Xianyun Tang 25 Reputation points

2026-01-18T02:33:39.97+00:00

Hi, @Todd Wang

I have escalated this issue to the Microsoft community. It has been confirmed and reported as a bug on the iOS platform.

Reference link: https://techcommunity.microsoft.com/discussions/TeamsDeveloper/ios-custom-app-icon-still-renders-as-white-square/4483264/replies/4483911
Todd Wang 0 Reputation points

2026-01-19T02:17:20.4733333+00:00

Hi, @**唐宪云
**Thank you for your reply. If there are any updates, please @ me again in this thread.
Best regards,
Todd Wang 0 Reputation points

2026-01-29T07:56:55.5533333+00:00

Hi, @**唐宪云
**I just noticed on the App Store that the Teams App has been updated to version 8.1.0. After updating, the app icon now displays correctly on higher versions of iOS devices.
Best regards

Answer accepted by question author

1 additional answer

Your answer

Todd Wang 0 Reputation points

2026-01-16T04:41:32.14+00:00

Hi, @唐宪云
These days, I have been uploading a Teams app and noticed issues with the iOS system. Currently, it has been found that icons cannot be displayed on iOS 18.7 and above, including the newly released iOS 26. May I ask which version of iOS you are having issues with?
Xianyun Tang 25 Reputation points

2026-01-18T02:33:39.97+00:00

Hi, @Todd Wang

I have escalated this issue to the Microsoft community. It has been confirmed and reported as a bug on the iOS platform.

Reference link: https://techcommunity.microsoft.com/discussions/TeamsDeveloper/ios-custom-app-icon-still-renders-as-white-square/4483264/replies/4483911
Todd Wang 0 Reputation points

2026-01-19T02:17:20.4733333+00:00

Hi, @**唐宪云
**Thank you for your reply. If there are any updates, please @ me again in this thread.
Best regards,
Todd Wang 0 Reputation points

2026-01-29T07:56:55.5533333+00:00

Hi, @**唐宪云
**I just noticed on the App Store that the Teams App has been updated to version 8.1.0. After updating, the app icon now displays correctly on higher versions of iOS devices.
Best regards

Answer 1

Kha-N 8,260 Microsoft External Staff Moderator

Hi @Xianyuntang,

Welcome to Microsoft Q&A, and thank you very much for reaching out to us.

Please note that our forum is a public platform, and we will modify your question to hide your personal information in the description. Kindly ensure that you hide any personal or organizational information the next time you post an error or other details to protect personal data.

Please note that as a Microsoft Q&A moderator, I don’t have access to your tenant configuration and my test environment is limited, so I can only assist based on available documentation and resources. That said, I’ll support you as much as possible.

Based on your description, I checked Microsoft’s guidelines for custom Teams app icons, and it looks like you’ve followed them correctly. I also checked the manifest snippet you provided, and everything appears to be properly configured. Since the icon renders normally on Android and desktop, this strongly indicates that the issue is tied to how Teams behaves on iOS rather than a problem with your app assets or manifest.

For a potential workaround, I came across a Q&A thread where a user resolved a similar mobile icon issue by uploading the app through the Teams Admin Center. While the thread did not explicitly confirm the fix as iOS‑specific, this deployment method has helped resolve cross‑platform icon recognition issues, and it may address the rendering problem you’re seeing on iOS.

User's image

I suggest giving this approach a try to see whether it resolves the icon issue on your end.

Looking forward to your response.

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

Kha-N 8,260 Reputation points Microsoft External Staff Moderator

2026-01-06T01:52:28.3466667+00:00

Hi @Xianyuntang,

I hope you are well.

I just wanted to follow up on your issue. Do you have any updates on this?

Warm thanks.
Xianyun Tang 25 Reputation points

2026-01-06T03:38:15.24+00:00

Hi Kha-N,

Thank you for the update and for verifying that my manifest configuration is correct.

Regarding the workaround you suggested, I wanted to share that I have actually attempted that method, but unfortunately, the issue persists. To provide more context, I have tested the following deployment scenarios, and the icon remains blank on iOS in all of them:

Direct Upload via Teams Admin Center: I tried uploading the app package directly through the Admin Center, but the icon still fails to render on iOS.

Commercial Marketplace: I have users who installed the app via the Commercial Marketplace, and they are also seeing a blank icon.

"Publish to Org" via Developer Portal: I also tried the "Publish to Org" feature within the Developer Center, and the result is the same.

Additionally, I would like to highlight that this issue started appearing only within the last one or two weeks.

Given that the issue is recent and isolated to the iOS platform, is it possible that this is a regression or a bug introduced in a recent update of the Teams iOS client?

Best regards,
Kha-N 8,260 Reputation points Microsoft External Staff Moderator

2026-01-06T04:13:00.8966667+00:00

Hi @Xianyuntang,

Thank you very much for your response and update.

At the moment, I’m unable to find any additional information that confirms this behavior is a known bug affecting the latest Microsoft Teams iOS client. I’ve also reviewed the Microsoft Health status reports, and there are no entries that match the symptoms you’re experiencing.

Given this, I recommend posting your issue on the Microsoft Tech Community. The Tech Community is an excellent place for deeper technical discussions and for connecting with individuals who have hands‑on experience and expertise. You may also find others encountering the same behavior or discover a workaround that could help in your scenario.

Another option is to open a ticket through Microsoft Developer Support for further assistance. Their engineers are best positioned to investigate issues at the product level and provide accurate, authoritative guidance when behavior falls outside what is documented or expected.

Please note that Developer Support works through paid support tickets, either via an active support plan or a one‑time purchase. The benefit of this route is that your case can be escalated directly to the Microsoft Product Group, which includes the engineers and developers who build and maintain the feature or service in question. I suggest using this option only if the issue becomes too disruptive or business‑critical.

Thank you for your understanding.

Answer 2

Todd Wang 0

Updating to Teams version 8.1.0 fixed this issue.

0 comments

Share via

[iOS] Custom App Icon still renders as white square after fixing accentColor and validating icons

1 additional answer

Your answer