Set up · Discord

Your buddy on Discord

Discord shows a bot's avatar as a circle. Use the pad file: the whole tile, centred on its own colour, so the circle cuts nothing.

What Discord shows: a circle, beside every message and in the member list.

Get the files

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

Avatar and app iconbrass-otto-pad-1024.png1024 × 1024 PNG, opaque
Emojibrass-otto-tile-128.png128 × 128 PNG, transparent corners

Animated versions are coming. Discord plays animated bot avatars, and an emoji per mode will follow.

Set it in the Developer Portal

Download the Avatar and app icon (the 1024 × 1024 PNG).
Open the Discord Developer Portal, go to Applications, and pick your app.
Click Bot in the sidebar. Click the icon next to the bot's username, choose the PNG, then click Save Changes.
For the app icon too: click General Information, upload the same PNG under App Icon, and save.
For the emoji: click Emojis, click Upload Emoji, and choose the 128 × 128 tile.

For agents

A bot can set its own avatar with PATCH /users/@me, and wear a different one in a single server with PATCH /guilds/{guild.id}/members/@me. Both take the image as a data URI.

Instructions

platform: discord (bot avatar)
crop:     circle, applied by Discord
variant:  pad (the tile at 74%, centred on its own ground colour, opaque)
file:     brass-otto-pad-1024.png
format:   PNG, 1024 x 1024 px, sRGB, no alpha
buddy:    Brass Otto
hash:     0x4f7857573d121112474507868c95e98e2cbb66d73cc61e786482793f28ed9bb0
method:   PATCH https://discord.com/api/v10/users/@me
body:     {"avatar": "data:image/png;base64,<the PNG, base64>"}
server:   PATCH /guilds/{guild.id}/members/@me with the same "avatar" field
emoji:    brass-otto-tile-128.png, 128 x 128 PNG, under 256 KiB
per-mode: do not change the avatar per state. Set a custom status in presence ("working").
checked:  2026-10-21

Limits

Format	PNG, JPG or GIF. App icon: PNG or JPG. WebP for avatars unverified
Max size	Emoji under 256 KiB. Avatars are shown from 16 to 4096 px.
Dimensions	Square. 1024 × 1024 for the avatar, 128 × 128 for an emoji.
Crop	Circle
Animation	Yes, bots can have animated avatars. Our animated files are coming.
Who can set it	You, in the Developer Portal. Or the bot itself, through the API.
Per-mode faces	Through a custom status, or a webhook's avatar per message. Avatar changes are rate-limited limit unverified, so don't swap it per state.

Last checked 2026-10-21 against User resource, Guild resource, Emoji resource and API reference. Platforms change: if a step is wrong, the platform's own docs win.