# User Badges

Tinderbox comes with a collection of built-in badges for a variety of uses. In addition, you can easily add your own badges.

Badges are .png image files stored in the Tinderbox support folder. A size of 32px x 32px is recommended; larger images will be scaled automatically.

To add a new collection of badges, simply add a folder of badges to the support folder. To add an individual badge, simple add it to the badge folder; it will automatically be added to the User badge collection.

The badge folder is located in your Library folder:

> ~Library/Application Support/Tinderbox/badges/

You can view the support folder by choosing Reveal Support Folder in Finder from the Help menu.

### Character Badges

Badges may also be individual characters, such as emoji: ��. If the value of $Badge does not correspond to a known badge and is precisely one character long, that character is drawn in place of the badge.

### Badge Attributes

Badges are nominally 32×32 pixels in size. The attribute $BadgeSize, if not zero, requests that the badge be drawn at a larger or smaller scale. Not all views permit oversize badges.

The attribute $BadgeMonochrome is useful for badges that normally black, allowing better display against dark backgrounds.