Set up · Teams & Copilot

Your buddy in Teams and Copilot

A Block Buddy is a face for your agent, drawn from its name. Teams, Outlook and Microsoft 365 Copilot round an app's icon themselves. Use the bleed file: a plain square, no rounding, no border.

What Microsoft shows: a rounded square, in the app bar, the store and beside the agent's messages.

Get the files

Drawn in your browser from the name above. Nothing is uploaded anywhere.

Colour iconbrass-otto-bleed-192.png192 × 192 PNG, square, opaque. Also the Copilot Studio icon: a few KB, under its 72 KB.
Colour icon, paddedbrass-otto-pad-192.png192 × 192 PNG, opaque. The whole tile at 74% on its own colour, so nothing reaches the edge.
Outline iconbrass-otto-mono-32.png32 × 32 PNG, white on transparent: the tile's outline and your buddy's two eyes. Every Teams app package needs one.
Card facebrass-otto-pad-128.png128 × 128 PNG, opaque, safe in a circle. For an Adaptive Card image.

The outline icon at 4×, on a dark ground. One colour and no blocks: they don't read at 32 px in one colour.

No animated files here: Microsoft takes PNG icons only, and cards don't play animated GIFs.

Set it on your app or agent

A Teams app or a Microsoft 365 Copilot agent:

Download the Colour icon (the 192 × 192 square) and the Outline icon.
Go to dev.teams.microsoft.com → Apps → your app → Branding.
Upload the PNG as the Color icon, and the Outline icon file as the Outline icon. Save.
Publish again: Publish to org (an admin approves it) or Preview in Teams. People see the new icon once the update reaches them.
If the bot also has an Azure Bot resource: in the Azure portal, open it → Bot profile → Icon, upload the same PNG, then Apply.

A Copilot Studio agent:

Download the Colour icon.
In Copilot Studio, open the agent, select the agent icon in the top bar → Change icon, pick the PNG, and Save. It can take up to a day to show everywhere.
For Teams: Channels → Teams and Microsoft Copilot → Edit details, set the icon and Save. If an admin already approved the agent, submit it for approval again.

For agents

The icon lives in the app package, and a person publishes it: there's no runtime API, and no face per message. An agent can still show its mode inside a reply, as an image in an Adaptive Card.

Instructions

platform: microsoft-teams, microsoft-365-copilot, copilot-studio
crop:     rounded square, applied by Microsoft ("do not round the corners", "don't add a border")
variant:  bleed (the tile with its corner clip off: art edge to edge, opaque)
file:     brass-otto-bleed-192.png
package:  appPackage/color.png (manifest icons.color), 192 x 192 PNG; keep the face in the centre 120 x 120
outline:  appPackage/outline.png (manifest icons.outline), 32 x 32 PNG, white on transparent. Required.
          file: brass-otto-mono-32.png (the tile's outline and the two eyes, white)
studio:   PNG, at most 192 x 192, under 72 KB (top bar > Change icon)
buddy:    Brass Otto
hash:     0x4f7857573d121112474507868c95e98e2cbb66d73cc61e786482793f28ed9bb0
method:   a person: Developer Portal (Branding) or the app package, then publish again. No runtime API.
per-mode: no avatar swap. Streaming status updates are text only, in one-on-one chats.
          For a face per state, send an Adaptive Card Image (an HTTPS PNG, up to 1024 px, no animated GIF, no redirects).
checked:  2026-10-21

Adaptive Card: the thinking face

{
  "type": "Image",
  "url": "https://YOUR-DOMAIN/brass-otto-pad-thinking-128.png",
  "style": "person",
  "size": "small",
  "altText": "Brass Otto is thinking"
}

A face per mode is hosted for the prebuilt names, so the URL above works as it is for them. For any other name, the download kit makes the idle still only, for now.

Limits

Format	PNG only
Max size	Copilot Studio: under 72 KB. Teams package icons: not documented unverified
Dimensions	Colour icon 192 × 192, the face inside the centre 120 × 120. Outline icon 32 × 32.
Outline icon	White, transparent, 32 × 32
Crop	Rounded square, applied by Microsoft. Don't round it or add a border.
Animation	No
Who can set it	The developer, in Developer Portal or the package. Changes need publishing again, and sometimes an admin's approval.
Per-mode faces	Not on the icon. Inside a reply, as a card image, yes.

Last checked 2026-10-21 against Design your app icons, Manifest icons, Copilot Studio: create an agent and Cards reference. If a step is wrong, the platform's own docs win.