Tenure and First-Time Badges
Go to Gamification > Badges in your admin menu.
Two kinds of badge reward a moment, not a total. First-time badges celebrate a member’s first post, first comment and similar. Tenure badges celebrate time as a member, such as one year. Both are ordinary badges with an editable rule. For the basics, see Badge Management and Badges.
First-Time Badges
Section titled “First-Time Badges”A fresh install includes these first-time badges. Each one awards when the member does the action once.
| Badge | Awarded for | Action it counts |
|---|---|---|
| Welcome Aboard | Joining the community | Join the site |
| First Post | Publishing a first post | Publish a blog post |
| First Comment | Leaving a first comment | Leave a comment |
| First Update | Posting a first activity update | Post an activity update (BuddyPress) |
| First Connection | Making a first friend | Accept a friendship (BuddyPress) |
The BuddyPress badges can only be earned while BuddyPress is active, because the action they count comes from BuddyPress.
What Makes Them Fire
Section titled “What Makes Them Fire”A first-time badge counts the member’s points history for one action. It awards as soon as that action pays points and the count reaches the number in the rule, which is 1.
That means the action must be able to pay points:
- Go to WB Gamification and click Points in the left menu.
- Find the action, for example Publish a blog post.
- Make sure its On switch is on and its Amount is above 0.
If you switch the action off or set it to 0, nothing is paid, so nothing is counted and the badge cannot award.
A first-time badge does not look backwards on its own. A member who posted before you created the badge gets it the next time they do the action. To award it to everyone who already qualifies, tick Also award this badge to members who already qualify when you save. See Change the Rule.
Tenure Badges
Section titled “Tenure Badges”A tenure badge awards after a member has had an account for a number of days, counted from the date they registered. The rule type is Has been a member for N days.
The plugin checks tenure once a day, because no member action can trigger it. A member who passes the mark is awarded the badge at the next daily check.
A new tenure badge also reaches long-time members this way. Everyone who is already past the mark receives it at the next daily check, even if you leave Also award this badge to members who already qualify unticked.
The Built-In Ladder
Section titled “The Built-In Ladder”A fresh install includes these four. The badge ID is shown in the edit form.
| Badge ID | Days | Roughly |
|---|---|---|
tenure_1yr |
365 | 1 year |
tenure_2yr |
730 | 2 years |
tenure_5yr |
1825 | 5 years |
tenure_10yr |
3650 | 10 years |
If you install the plugin on an established community, long-time members receive every tenure badge they already qualify for at the first daily check, about an hour after activation. That first check is silent: no feed posts, toasts, emails or webhooks, because these badges mark the past. From then on, a member who reaches a tenure date is announced as usual. To hold the badges back altogether, switch them off first. See Turn a Badge Off.
A site first installed on an older version may not have these four. If you do not see them in the Badges library, add the ones you want. An update never adds them, because it cannot tell a badge that was never created from one you deleted. See Add a Tenure Badge.
Change the Rule
Section titled “Change the Rule”- Go to Gamification > Badges.
- Click the badge card.
- Under Auto-Award Conditions, change the number. For example, set a tenure badge to
548days for 18 months. - Tick Also award this badge to members who already qualify only if you want existing members to receive it now. It is off by default.
- Click Save Changes.
The rule is a normal condition, so you can add more with + Add condition and choose whether the member must match ALL of these or ANY of these. For example, require 365 days as a member and 500 points.
Saving a rule changes who can earn the badge from now on. It never removes a badge a member already holds.
Turn a Badge Off
Section titled “Turn a Badge Off”Each badge is switched off on its own.
- Open the badge in the library.
- Set its condition to Admin awarded only (manual).
- Click Save Changes.
The badge now awards only when you grant it by hand, and the library card changes from Auto-award to Manual. Members who already hold it keep it.
To remove a badge completely, open it and click Delete Badge. This also removes it from every member who earned it.
Add a Tenure Badge
Section titled “Add a Tenure Badge”- Go to Gamification > Badges and click + Create New Badge.
- Enter a Badge ID such as
tenure_3yr, a Name such as “3-Year Member”, and an Icon. - Under Auto-Award Conditions, choose Has been a member for N days and enter
1095. - Click Create Badge.
Add a First-Time Badge
Section titled “Add a First-Time Badge”- Click + Create New Badge.
- Fill in the Badge ID, Name, Description and Icon.
- Choose Performs an action N times, pick the action from the list, and enter
1. - Click Create Badge.
Make sure the action is switched on and pays points. See What Makes Them Fire.
Site-First Badges
Section titled “Site-First Badges”A site-first badge goes to only the first member who does something: reach a level, earn a point total, or hold a streak. It is a normal badge with Max earners set to 1. Once one member has it, nobody else can earn it.
A fresh install includes three, and a site first installed on an older version may need to add them by hand: first_champion (reach the Champion level, or your highest level if you have no Champion), first_10k_points (10,000 points) and first_100_day_streak (a 100-day streak). You can create your own the same way, with Max earners set to 1.
Who Can Manage Badges
Section titled “Who Can Manage Badges”Administrators, and staff given the Manage badges permission. See Staff Permissions.
See Also
Section titled “See Also”- Badge Management lists every badge field.
- Badges explains how badges work for members.
- Badge Credentials turns a badge into a shareable credential.

