Award medals and qualifications
Recognise achievements and record progression requirements on Clan Labs member profiles.
Last updatedMedals recognise a member’s contribution or achievement. Qualifications record approved skills or credentials and can be used as progression context. Both are scoped to the community.
Manage award definitions
Open Medals or Qualifications in community management to search the definition cards. A card shows the definition's name, ID, description, and configured Discord role. Use Update and Delete when you have configuration access, or View when read-only access is available.
Definition management is separate from awarding or removing an award on a member.
Award or remove a medal
Use a member profile or /medal award:
- Find the intended member.
- Select the medal configured by the community.
- Confirm the award and check the member profile.
Repeated awards through the public API or /medal award add another occurrence of that medal. /medal unaward and the public API's medal removal remove one occurrence at a time. Use the member profile to review the resulting awards. Awarding or removing a medal for selected members defaults to Officer. Awarding or removing one for every member defaults to Owner.
API v2 can list medal definitions, fetch one by name, award a member, and remove an award. Use medals.read for definitions and members.medals.write for member changes.
Assign or revoke a qualification
Use /qualification assign or the profile action, select the configured qualification, and confirm it. /qualification revoke removes it. The default requirement for qualification changes is HICOM.
Qualifications require a plan that includes the feature. They may be referenced by automated progression rules, so revoking one can affect future eligibility even when the member’s current Roblox rank does not immediately change.
API v2 can list and fetch qualification definitions and award or remove one from a member with the matching read or write scope.
Confirm the result
After any recognition change:
- check the target profile;
- confirm the exact medal or qualification name;
- review the audit entry;
- if Discord presentation depends on the change, run
/updateand inspect its result.
The public API allows up to 1,000 total medal occurrences per member, across all medal types. Another award at the limit returns 409 medal_limit_reached. Removal remains available and can free a slot.
After a timeout, read the member's current medal occurrences before repeating either an award or removal: the first request may already have changed the count. Qualification awards remain a no-op when already held. See API retry guidance.
Resolve any blacklist or active-suspension message before retrying an award. Use distinct award names and clear qualification requirements.
If the action is hidden, check its plan feature and community permission. For progression, continue to Experience and quotas.