Ranks and how they work
Ranks help you recognize participation, shape member behavior, and unlock specific abilities across your community. In Vanilla, a rank can grant or remove privileges, and it can be assigned manually or earned automatically through configured criteria like points or post counts.
Ranks are not the same as roles. Roles control access, moderation, and administrator permissions, while ranks are typically used to reward engagement, identify member status, and control ability progression over time.
How rank assignment works
A user can only have one rank at a time. If a user qualifies for multiple automatic ranks, they receive only the highest rank they qualify for, not every lower rank along the way.
Rank order matters because level determines precedence. Higher level ranks take priority over lower ones, so if you want a manually assigned rank to stay in place, it should be set higher than any automatic rank that could otherwise override it.
What makes up a rank
Each rank includes a few key settings:
- Name, which is what users typically see in rank related notifications.
- Label, which is what appears next to a user’s name in posts and comments after they receive the rank.
- Level, which determines which eligible rank takes precedence when multiple criteria are met.
- Criteria, which define how the rank is earned.
- Abilities, which control the privileges associated with that rank.
One important detail is that the Name and Label fields do different jobs. The Name is used for achievement messaging, while the Label is what displays in the UI next to the member’s name.
Where ranks appear
Ranks are commonly displayed on posts, comments, and profile areas so other members can quickly understand a user’s standing in the community. They are often used to highlight trusted members, moderators, administrators, or highly engaged contributors.
What happens when ranks change
When a new rank is added or an existing rank is edited, Vanilla can perform a Rank Check to make sure users have the proper rank and update assignments if needed. That process can also trigger notifications for users who have enabled rank change notifications. Rank messages can appear in app and by email depending on configuration.
Best practices
- Keep your rank structure simple so it is easy to manage and easy for members to understand.
- Start with a small set of ranks, then expand only if your community has a clear need.
- Consider dedicated ranks for moderators and administrators so they are easy to identify publicly.
- Use criteria and abilities together to encourage the behaviors you want to see in the community.
In short
Ranks are a lightweight way to recognize member progress, unlock abilities, and guide participation in your community. They work best when the rules are clear, the levels are intentional, and each member can easily understand what their rank means.