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

Manage user and group blacklists

Exclude a Roblox user or members of a Roblox community from supported Clan Labs workflows.

Last updated 3 September 2026

A blacklist is an explicit community moderation rule. Clan Labs supports two target types:

  • User — a particular Roblox user ID.
  • Group — a Roblox community ID; members of that community can be rejected by guarded workflows.

The implementation stores an entry until authorised staff remove it. The current Clan Labs blacklist model does not expose a temporary expiry field, so do not describe an entry as automatically expiring.

Create an entry

Use /blacklist create or the corresponding dashboard workflow:

  1. Choose User or Group.
  2. Find and verify the Roblox target. Use its numeric ID to avoid ambiguity.
  3. Add a clear reason or description.
  4. Submit the entry and confirm it appears with /blacklist view or in Clan Labs.
  5. Review the audit record.

The default requirement for blacklist actions is HICOM. Community owners can configure a different minimum.

Where Roblox can resolve the target, Clan Labs uses its canonical Roblox name. The public API also accepts a fallback display name so the operation can be recorded during a temporary Roblox lookup problem; the numeric ID remains authoritative.

How enforcement appears

Supported commands check both direct user entries and membership in blacklisted Roblox communities. A guarded action can report that the user is blacklisted from this community or belongs to a blacklisted community. This can block progression, pending-join review, medals, qualifications, and similar member operations.

Update or remove an entry

The dashboard and /blacklist delete can remove an entry when authorised. API v2 supports listing, fetching, creating, updating the description, and deleting entries with blacklists.read or blacklists.write.

Before deleting, confirm the target type and ID. A user ID and group ID can have the same number but are different blacklist records.

Moderation practice

  • Use a factual reason and follow your community’s appeal policy.
  • Do not include credentials, unrelated personal data, or private staff speculation.
  • Restrict blacklist writes more tightly than reads.
  • Review group-wide exclusions carefully; they can affect many people.
  • Remove an entry when the approved restriction ends; it does not expire by itself.

For a time-limited rank restriction, use Suspensions. For a lower-severity record, use Warnings.

PreviousSuspensionsNext Medals and qualifications
On this page
  1. Create an entry
  2. How enforcement appears
  3. Update or remove an entry
  4. Moderation practice