Rotating server icons
Upload a set of server icons and let Buddy rotate them on a schedule, with playlists for seasonal sets and member submissions from Discord.
On this page
The icon manager works like the banner manager, but for your server icon (the round picture in everyone's server list). Upload a few icons, mark the ones you want as Active, and Buddy swaps them on a schedule. Great for seasonal looks, event themes or just keeping things fun. Unlike banners, rotating icons don't need any boosts.
Before you start#
- Image size: use square images, ideally 512x512. JPEG, PNG and GIF are supported. Dashboard uploads must be under 5 MB.
- Animated icons (GIF) need Boost Level 1 or higher. Without it, Buddy skips GIF icons and moves on to the next one.
- Free servers can have up to 5 Active icons and rotate every 4 hours. Premium raises both (see Premium).
Set it up#
It's under Branding in the sidebar.
In Icon images, choose a file under Upload an icon and click Upload icon. New uploads start as Pending.
Change the icon's Status to Active in the Icon images table. Changes save as soon as you pick an option.
Icons start in the default playlist, which is active unless you change it. Only Active icons in the Active playlist rotate.
In Rotation interval, pick how often to Change icon and click Save interval.
When you activate your first icon from Discord, Buddy uploads it straight away. After that, it moves to the next Active icon at each interval, in upload order, and loops back to the start.
Icons are uploaded exactly as you made them. Buddy doesn't crop them or add a watermark, so square images look best.
Icon statuses#
| Status | Meaning |
|---|---|
| Pending | Uploaded but not approved. Every new upload starts here. Never rotates. |
| Active | Approved and part of the rotation (if it's in the Active playlist). |
| Disabled | Kept but skipped. Buddy disables an icon automatically if its file is 10 MB or larger. |
Settings explained#
| Setting | What it does | Default |
|---|---|---|
| Change icon (Rotation interval) | How often Buddy switches to the next Active icon. Shorter intervals need Premium. | Every 4 Hours |
| Playlist (Active playlist) | Which playlist rotates. | default |
| Status (Icon images) | Active, Disabled or Pending for each icon. | Pending |
| Playlist (Icon images) | Which playlist each icon belongs to. | default |
| New playlist (Playlists) | Create a playlist, up to 32 characters. Click Create playlist. | — |
Icon playlists#
Playlists let you keep separate sets, like a normal set and a holiday set, and switch which one rotates. On the Icon manager page:
- Create a playlist under Playlists (New playlist, then Create playlist).
- Move icons into it with the Playlist menu in Icon images.
- Pick it in Active playlist and click Save active playlist.
You can have up to 10 playlists, including default. Deleting a playlist moves its icons back to default. Playlists work the same way as banner playlists; see Banner playlists and overlays for the details and naming rules.
Commands#
/edit_icons <status> Manage MessagesEdit server icons by status.
/icon_status EveryoneView Icons Status.
/upload_icon <image_file> EveryoneSubmit a new server icon image.
/upload_icon_staff <image_file> Manage MessagesStaff submit a new server icon image.
/view_icons EveryoneView active server icons.
| Command | Who can use it | What it's for |
|---|---|---|
/upload_icon | Everyone | Members submit an icon. It arrives as Pending for staff to review. |
/upload_icon_staff | Manage Messages | Staff upload an icon. |
/view_icons | Everyone | Browse the Active icons. |
/edit_icons | Manage Messages | Review icons by status, with Enable, Disable, Delete and Add To Playlist buttons. |
/icon_status | Everyone | See the rotation frequency, next update, selected playlist, icon counts and the current icon. Change Playlist switches the active playlist. |
Each member can have up to 3 icons waiting for review (25 per server), and must wait 30 seconds between submissions. Members with Manage Messages aren't limited. Images can be up to 10 MB.
Icon playlists can also be managed with /rotation_playlist type:Icons: pick the active playlist, and pick an icon to see it and move it to another (or a new) playlist.
/rotation_playlist [type] Manage MessagesChoose which playlist rotates and move banners or icons between playlists.
Examples#
A spooky October:
- Upload three Halloween icons with
/upload_icon_staff. - Run
/edit_iconswith status set to Pending Icons, then click Add To Playlist on each and create a playlist calledhalloween. - Enable each one.
- Run
/rotation_playlist type:Iconsand set Active playlist to halloween. - On November 1st, run it again and set Active playlist back to default.
Premium#
| Free | Premium | |
|---|---|---|
| Active icons | 5 | More, depending on your plan |
| Fastest rotation | Every 4 hours | Every hour, 30 minutes or 15 minutes, depending on your plan |
The Icon manager page shows how many Active icons you're using against your limit. Compare plans on the Premium page.
Icon uploads, from Discord or the dashboard, don't need Premium. A plan that includes no icons refuses uploads with a private message.
Troubleshooting#
The icon never changes#
- At least one icon must be Active and in the Active playlist. New uploads are Pending.
- Buddy needs Manage Server.
- With only one Active icon, there's nothing to rotate to.
- Run
/icon_statusto see the rotation frequency, the next update and how many icons are Active.
My GIF icon is skipped#
Animated icons need Boost Level 1 or higher. Until then, Buddy skips GIFs and uses the next icon.
"This server has reached max number of active icons"#
You've hit your plan's limit. Disable an icon you don't need, or upgrade to Premium.
My upload was rejected#
Dashboard uploads must be a JPEG, PNG or GIF under 5 MB. In Discord, the file must be a
.jpg, .jpeg, .png or .gif image.