Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stellarbot.dev/llms.txt

Use this file to discover all available pages before exploring further.

When a new member joins your server, Stellar can automatically assign them a role before they interact with anyone. This is useful for granting access to general channels, applying a “Member” label, or starting users in a restricted state until they complete onboarding. Auto-role is configured with three simple slash commands and requires the Manage Server permission.
Auto-role and the verification system cannot be active at the same time. If verification is already enabled, you must disable it before turning on auto-role, and vice versa.
Stellar’s bot role must be positioned above the auto-role role in your server’s role hierarchy. If Stellar’s role is lower, it will not have permission to assign the role to new members.

Setup guide

1

Set the role

Choose the role Stellar should assign to every new member.
/autorole setrole [role]
The role cannot be higher than your own highest role, cannot have the Administrator permission, and cannot be a managed role (such as a bot integration role).
2

Enable auto-role

Once a role is set, turn the system on.
/autorole toggle
Running /autorole toggle without a role configured will return an error asking you to set one first.
3

Confirm your configuration

Verify everything looks correct.
/autorole config

Commands

/autorole setrole [role]

Sets the role Stellar will assign to every new member who joins your server.
/autorole setrole @Member
The following roles cannot be used:
  • Roles positioned higher than your own highest role
  • Roles with the Administrator permission
  • Managed roles (created and controlled by bot integrations)

/autorole toggle

Enables or disables the auto-role system. Calling this command toggles the current state — no extra arguments required. A role must be configured with /autorole setrole before you can enable the system.
/autorole toggle

/autorole config

Shows the current auto-role configuration, including whether the system is enabled and which role is assigned.
/autorole config
Last modified on May 6, 2026