Badges in Discourse reinforce positive user behaviour and facilitates “learning by doing”. It is a central part of Discourse’s gamification features.
Receiving Badges
There are two ways to receive a badge:
- Manually granted by an administrative user
- Automatically granted by the system
Furthermore, all badges have some optional properties.
- Allow badge to be used as a title
- Can be granted multiple times
- Show badge on the public badges page
- Show post granting badge on badge page
Creating Badges
Manual and automatic badges are created the same way, via the admin panel. What sets them apart is how they’re triggered.
Manual Badges
A badge can only be granted by an administrative user. See how to manually grant a badge.
Automatic Badges
Automatic badges are granted by special triggers. Discourse comes with a lot of default badges out of the box, but administrative users can also create custom ones. At their most basic, automatic badges are simple “kudos!” for users who are just starting out.
For example:
- Added a link
- Received a like.
Certain badges also coincide with trust levels. When you’ve attained a new trust level, you’ll receive a corresponding badge to notify you of the bump-up.
- Trust Level 1 --> Basic
- Trust Level 2 --> Member
- Trust Level 3 --> Regular
- Trust Level 4 --> Leader
Want to create your own automatic badge? Go read how to trigger custom badge queries.
Badge Types and Groups
By default, badges are grouped into the following categories:
- Getting Started
- Community
- Posting
- Trust Level
- Other
When viewing a badge in the admin panel, you can use the button next to the “Group” dropdown to create custom badge groups. You can also adjust the position of each badge group as they appear on the
/badges
page of your site. If you need to modify the names of the default badge groups, visit /admin/customize/site_texts?q=js.badges.badge_grouping
on your site to customize the text.
In addition to badge groups, badges are classified into three types. These include Bronze, Silver, and Gold. Each badge group will display Bronze badges first, then Silver, then Gold. The idea is to have the type reflect how difficult the badge is to acquire, with Gold being the most challenging.
Further Reading
-
Granting techniques
-
Badge Queries
-
Miscellaneous