Icon Packs
Replace Discord's icons with your own.
An icon pack is a folder of images that replace Discord's icons by name. It ships no code.
How It Works
- Discord requests each icon by name, such as
ic_message_delete. - If your pack has an image with that name, Unbound shows it instead.
- Names you leave out keep Discord's icon.
- One pack applies at a time. Enabling another replaces it; disabling restores Discord's icons.
The names a pack targets are the ones the assets module discovers.
File Layout
Each image sits at the path of the Discord asset it replaces, without the leading assets/.
- my-pack
- manifest.json
- images
- ic_message_delete.pngScale 1
- [email protected]Scale 2
| Suffix | Scale |
|---|---|
| none | 1 |
@2x | 2 |
@3x | 3 |
Unbound uses the highest scale present, so shipping only @3x works.
Install Sources
Unbound installs a pack from its manifest URL. The manifest's source sets how files download. For in-app steps, see Managing Addons.
source | Behavior |
|---|---|
| GitHub | main is the repo URL, optionally narrowed with /tree/<branch>/<subpath>. Unbound downloads every file under that path. Used by default when source is omitted and main is a github.com URL. |
| Other | Downloads like any other addon bundle. |
To install, enable or list packs from code, see iconPacks in the SDK reference.