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.
Reviewing badges
You can go to /badges
page of your site to view a list of all the avalaible badges, organized by group. Each badge has a at the top left corner to indicate you’ve been granted the badge. At the top right corner there is a counter of the total number of users that have been granted the badge (since the site was created). If you click at the badge, you can see more details about the badge and the users who earned it.
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.
Disabling badges
You can disable badges, and remove them from the users summary page, by unchecking the setting enable badges
.
Further Reading
-
Granting techniques
- 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
-
Badge Queries
-
Miscellaneous