web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

News and Announcements icon
Community site session details

Community site session details

Session Id :
Power Platform Community / Forums / Copilot Studio / Copilot Studio agent i...
Copilot Studio
Suggested Answer

Copilot Studio agent icon / logo to custom image

(2) ShareShare
ReportReport
Posted on by 46
Hi,

I’m running into a weird issue with changing a Copilot Studio agent icon/logo and wanted to see if anyone has found a reliable fix.

I’ve already tried:

  • changing the icon directly inside the Copilot Studio agent settings
  • updating it through Microsoft/Teams Admin Center
  • republishing the agent multiple times
  • unzipping the app package, manually replacing the icon files, zipping it back up, and re-uploading it

But the icon still won’t update in Teams or in the Admin center. It keeps showing the old/default icon.

From the docs it sounds like this should work through:
Channels → Microsoft Teams & Microsoft 365 → Edit details → upload new icon

…but in practice the update doesn’t seem to propagate correctly.

Has anyone found a proper way to force the icon/logo to refresh in:

  • Teams
  • Teams Store / “Built with Power Platform”
  • Microsoft 365 Copilot

Do I need to publish the app as a completely new version/app, clear some cache somewhere, or is this currently just a platform limitation/bug?

- Vektori
I have the same question (0)
  • Suggested answer
    RaghavMishra Profile Picture
    68 on at

    Hi Vektori,

    What you're hitting is almost always the publish/approval pipeline rather than the icon upload itself. A Copilot Studio agent surfaced in Teams is technically a Teams app, and once it has been approved in the Teams Admin Center the app metadata (including the icon) is cached at three different layers — Copilot Studio, Teams Admin Center, and the Teams client. Updating only one layer leaves the old icon in place.

    The supported end-to-end refresh path

    1. Update the icon inside Copilot Studio → open the agent → ChannelsTeams and Microsoft 365 CopilotEdit details → upload the new color icon (192×192 PNG) and outline icon (32×32 transparent PNG). These dimensions are required by the Teams app manifest; off-spec icons silently fall back to the default. See Add a copilot to Microsoft Teams and the Teams app manifest schema.
    2. Publish the agent again in Copilot Studio. Channel/details changes only take effect after a fresh publish — this is the most common reason icons appear "stuck."
    3. Re-submit to the Teams admin catalog. In the same Teams channel pane, use Availability optionsShow to my org by submitting to admin, or download the updated app package and re-upload it in Teams Admin Center. The Microsoft 365 Copilot channel has its own publish step — see Connect and publish agents to Microsoft 365 Copilot.
    4. Have a Teams admin approve the updated version in Teams Admin Center → Manage apps. Updated app metadata (including the icon) won't propagate to end users until the new version is explicitly published/approved in the catalog. Reference: Manage apps in the Microsoft Teams admin center.
    5. Clear the Teams client cache on at least one test machine before judging the result. Sign out of Teams, quit fully, delete the contents of %appdata%\Microsoft\Teams (classic) or %localappdata%\Packages\MSTeams_8wekyb3d8bbwe\LocalCache (new Teams), then sign back in. Steps: Clear the Teams client cache.

    Why manually editing the zipped app package doesn't work

    When the agent is managed by Copilot Studio, the authoritative manifest is the one Copilot Studio generates on publish. A hand-edited package re-uploaded through Teams Admin Center will be overwritten the next time the agent is published from Copilot Studio, which is why the old icon keeps coming back. The documented path is to make the change in Copilot Studio's Edit details pane and publish — not to edit the package directly.

    About the "Built with Power Platform" / Microsoft 365 Copilot surfaces

    Those are separate channels with their own publish/approval cycle. After step 2 above, also re-publish to Microsoft 365 Copilot from the Channels pane, and expect a propagation delay on the Copilot/Teams Store side — this is documented behavior, not a bug. See Connect and publish agents to Microsoft 365 Copilot.

    If after all five steps the admin sees the new icon in Teams Admin Center → Manage apps → [your agent] → version history but end users still see the old one, it's a Teams client cache issue and step 5 is the fix. If the admin doesn't see a new version listed, the publish in step 2 or the submission in step 3 didn't go through and that's where to focus.

    Found this helpful? Please mark ✅ "Does this answer your question?" so others searching for the same issue can find it quickly. A 👍 on "Was this reply helpful?" or a ♥ Like is also much appreciated!

    Raghav Mishra — LinkedIn | PowerAI Labs

  • Suggested answer
    Haque Profile Picture
    3,249 on at
    Hi @Vektori1,
     
    Can you please try a quick shortcut?

    Once your icon is updated, please update the agent’s version number in the settings (e.g., from v1.0 to v1.1 for example). This is critical because Teams and the Teams Store rely on version changes to detect updates. After updating the icon and version, republish the agent to the desired channels. Once republished - try in incognito mode in a browser for testing.
     
     

    I am sure some clues I tried to give. If these clues help to resolve the issue brought you by here, please don't forget to check the box Does this answer your question? At the same time, I am pretty sure you have liked the response!
  • Suggested answer
    11manish Profile Picture
    2,430 on at
    Yes — this is currently a known caching/propagation issue (and in some cases a platform limitation) with Copilot Studio + Teams app publishing. Republishing
     
    alone often does not refresh icons, logos, descriptions, or branding metadata correctly in Teams or Microsoft 365 Copilot.
     
    The most reliable fix is:
    • increment the manifest/app version,
    • download a fresh manifest,
    • re-upload it through Teams Admin Center,
    • clear Teams cache,
    and sometimes completely remove the old Teams app entry before republishing.
     
    If none of that works, creating a completely new app/package is unfortunately sometimes the only effective workaround today.
  • Suggested answer
    Valantis Profile Picture
    5,479 on at
     
    This is a confirmed known issue. Agent metadata like icon and logo often doesn't update in Teams even after republishing due to Teams app packaging and backend caching. (or it take many hours days until you can see it in teams) for me it apears after few days, then for another Agent still didnt apear after publish before few weeks but i can see the icon in the chat response when the Agent is replying.
     
    what you can try is this the step below but once you have the correct pixel / format its only about waiting to apear at some point :)

    The steps that actually force it through:
    1. Remove the Teams channel in Copilot Studio, wait a few minutes, re-add it and republish. This generates a new app package.
    2. In Teams Admin Center, delete the submitted app entirely, then resubmit the new package. Republishing alone doesn't always trigger a manifest update on the Teams side.
    3. If you're manually editing the ZIP package, the manifest.json version number must be incremented (e.g. 1.0.0 → 1.0.1). Teams rejects icon updates if the version hasn't changed.
    4. Users need to uninstall and reinstall the app in Teams after the admin updates it. Teams caches the app package per user and doesn't auto-update the icon.
    The unpublish → wait → republish pattern is confirmed as the most reliable way to force propagation. If it still doesn't update after all of this, raise a Microsoft support ticket  this has been an open issue for some time.
     

     

    Best regards,

    Valantis

     

    ✅ If this helped solve your issue, please Accept as Solution so others can find it quickly.

    ❤️ If it didn’t fully solve it but was still useful, please click “Yes” on “Was this reply helpful?” or leave a Like :).

    🏷️ For follow-ups  @Valantis.

    📝 https://valantisond365.com/

    💼 LinkedIn

    ▶️ YouTube

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Introducing the 2026 Season 1 community Super Users

Congratulations to our 2026 Super Users!

Kudos to our 2025 Community Spotlight Honorees

Congratulations to our 2025 community superstars!

Congratulations to the April Top 10 Community Leaders!

These are the community rock stars!

Leaderboard > Copilot Studio

#1
Valantis Profile Picture

Valantis 455

#2
Vish WR Profile Picture

Vish WR 273

#3
Romain The Low-Code Bearded Bear Profile Picture

Romain The Low-Code... 202 Super User 2026 Season 1

Last 30 days Overall leaderboard