Badges in Discourse reinforce positive user behaviour and facilitates “learning by doing”. It is a central part of Discourse’s gamification features.
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
Manual and automatic badges are created the same way, via the admin panel. What sets them apart is how they’re triggered.
A badge can only be granted by an administrative user. See how to manually grant a badge.
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.
- 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
- Trust Level
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.
- How to grant a custom badge through the API
- How to make requests to the Discourse API with Zapier (see Grant a custom badge section)
- How to award a non-custom badge through the console
- Grant a badge to individual users manually
- Award a badge to a set of users (Bulk award using CSV)
- Grant a custom badge to all members of a group from the console