Skip to main content

Mod Role & Permissions

How Permissions Work

Chat Rewards has two permission tiers:

  • Manage Server — Standard Discord permission. Anyone with this can use all Chat Rewards management commands that support it.
  • Mod Role — A role you assign via /mod-role. Members with this role can use the same commands as someone with Manage Server, without actually having that Discord permission.

Some sensitive commands require Administrator regardless of the Mod Role:

  • /mod-role (setting/changing the mod role itself)
  • /credits purge (irreversibly deletes all credits)
  • /whitelabel (bot branding customization)

The server owner always has full access.

Setting the Mod Role

/mod-role @role

This requires the Administrator permission.

Examples:

/mod-role @Moderators   — grants the @Moderators role full Chat Rewards management access
/mod-role — leave blank to remove the Mod Role

Only one role can be set at a time. Setting a new role replaces the previous one. Clearing the mod role means only users with Manage Server or Administrator can manage Chat Rewards.

Why Use a Mod Role?

It lets trusted staff manage Chat Rewards without giving them full Manage Server permission. Useful if you have moderators who need to manage shop items, give/remove credits, or spawn rewards — but you don't want to grant them broad server permissions.

info

You can view which commands support the Mod Role at chatrewards.xyz/commands — click any command to see its "Permissions" section.

Changes to the Mod Role are recorded in your configured logging channel.