Stoatmod / Role automation

Configure automatic roles

Automatic-role configuration is successful only when a newly joined member actually receives every intended role.

All documentation

The details, in one place.

Add, list, test and remove Stoatmod automatic roles while respecting Assign Roles permission and role hierarchy.

  • Reviewed 31 August 2026
  • 3 sections
  • Documentation

Add and review roles

~auto-role ROLE_ID

Add a role with the short form.

~auto-role add ROLE_ID

Add a role explicitly.

~auto-role list

Review the configured list.

~auto-role remove ROLE_ID

Remove one role.

~auto-role clear

Clear every role.

Permission requirements

  • Assign Roles and Manage Roles must be effective.
  • Stoatmod must sit above each assigned role.
  • The target role must still exist.
  • The dashboard list supports up to 25 roles.

Test the result

  1. 01

    Run setup

    Resolve hierarchy and permission issues.

    ~setup
  2. 02

    Copy the role ID

    Avoid display-name ambiguity.

  3. 03

    Join with a controlled account

    The role flow runs on a new join.

  4. 04

    Inspect the member

    Confirm each role exists on the member before trusting the event record.

Ready to configure a server?

Install Stoatmod, then verify the first outcome.

Open the official bot profile →