Skip to content
Clan LabsDocs
API referenceWebsite Open dashboard
Get startedDashboardDiscord botRoblox & Open CloudTroubleshooting
Documentation
Overview
  • Introduction
  • What is Clan Labs?
  • Core concepts
  • Requirements
  • Plans and availability
  • Quick start
Getting Started
  • Create or sign in
  • Add the Discord bot
  • Start setup with /setup
  • Select a Discord server
  • Connect a Roblox community
  • Confirm ownership
  • Choose a subscription
  • Configure Open Cloud
  • Complete setup
  • Recommended next steps
Setup Guides
  • Discord bot permissions
  • Roblox community connection
  • Roblox Open Cloud
  • Verification
  • Group and rank binds
  • Community permissions
  • Experience
  • Quotas
  • Welcome messages
  • Audit-log delivery
  • Events
  • Subscriptions
  • API keys
  • Divisions
Feature Guides
  • Member management
  • Profiles
  • Linked Roblox accounts
  • Experience and quotas
  • Ranks and group binds
  • Warnings
  • Suspensions
  • Blacklists
  • Medals and qualifications
  • Events and attendance
  • Audit logs and rollback
  • Analytics
  • Community permissions
  • Discord commands and actions
  • Pending join reviews
  • Custom bot branding
  • Discord server transfers
  • Privacy and account controls
  • Subscriptions and billing
Troubleshooting
  • Troubleshooting overview
  • Discord server is missing
  • Roblox community not found
  • Ownership cannot be confirmed
  • Bot permissions are missing
  • Discord role does not update
  • Role is above the bot
  • Verification fails
  • Open Cloud errors
  • Rank change fails
  • Profile does not sync
  • Command is unavailable
  • Action is not permitted
  • Subscription access is missing
  • Temporary service problem
API referenceClan Labs websiteOpen dashboard Support
Overview
  • Introduction
  • What is Clan Labs?
  • Core concepts
  • Requirements
  • Plans and availability
  • Quick start
Getting Started
  • Create or sign in
  • Add the Discord bot
  • Start setup with /setup
  • Select a Discord server
  • Connect a Roblox community
  • Confirm ownership
  • Choose a subscription
  • Configure Open Cloud
  • Complete setup
  • Recommended next steps
Setup Guides
  • Discord bot permissions
  • Roblox community connection
  • Roblox Open Cloud
  • Verification
  • Group and rank binds
  • Community permissions
  • Experience
  • Quotas
  • Welcome messages
  • Audit-log delivery
  • Events
  • Subscriptions
  • API keys
  • Divisions
Feature Guides
  • Member management
  • Profiles
  • Linked Roblox accounts
  • Experience and quotas
  • Ranks and group binds
  • Warnings
  • Suspensions
  • Blacklists
  • Medals and qualifications
  • Events and attendance
  • Audit logs and rollback
  • Analytics
  • Community permissions
  • Discord commands and actions
  • Pending join reviews
  • Custom bot branding
  • Discord server transfers
  • Privacy and account controls
  • Subscriptions and billing
Troubleshooting
  • Troubleshooting overview
  • Discord server is missing
  • Roblox community not found
  • Ownership cannot be confirmed
  • Bot permissions are missing
  • Discord role does not update
  • Role is above the bot
  • Verification fails
  • Open Cloud errors
  • Rank change fails
  • Profile does not sync
  • Command is unavailable
  • Action is not permitted
  • Subscription access is missing
  • Temporary service problem
  1. Docs
  2. /
  3. Feature Guides
Feature Guides

Award medals and qualifications

Recognise achievements and record progression requirements on Clan Labs member profiles.

Last updated 3 September 2026

Medals 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.

Award or remove a medal

Use a member profile or /medal award:

  1. Find the intended member.
  2. Select the medal configured by the community.
  3. Confirm the award and check the member profile.

Use /medal unaward or the Clan Labs profile control to remove it. The default requirement for an individual medal action is Officer. Awarding a medal broadly with the supported all-member workflow 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 /update and inspect its result.

Awarding a medal already held is treated as a no-op by the public API, but integrations should still read the member state when reconciling uncertain results.

Good practice

  • Use stable, distinct names for configured awards.
  • Publish qualification requirements so staff apply them consistently.
  • Restrict create/edit settings more tightly than routine awards.
  • Never use a qualification as an unrecorded moderation flag.
  • Resolve blacklist or active-suspension messages before retrying an award.

If the action is hidden, check its plan feature and community permission. For progression, continue to Experience and quotas.

PreviousBlacklistsNext Events and attendance
On this page
  1. Award or remove a medal
  2. Assign or revoke a qualification
  3. Confirm the result
  4. Good practice