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.

Stellar’s verification system lets you gate access to your server behind a single button click. When a new member joins, they see a channel with a verification embed containing a button. Clicking it grants them a role you choose — typically the role that unlocks the rest of your server. This keeps bots, raiders, and lurkers from accessing your channels until they actively confirm they are human. Setup requires the Manage Server, Manage Roles, and Send Messages permissions.
The verification system and auto-role cannot both be enabled at the same time. Enabling one while the other is active will result in an error. Disable one before enabling the other.

How it works

  1. Stellar posts a custom embed with a verify button into the channel you specify.
  2. A new member joins and is restricted to only that channel (based on your role permissions).
  3. The member clicks the button in the verification embed.
  4. Stellar immediately assigns the verification role to the member, granting them access to the rest of the server.

Setup guide

1

Set the verification role

Choose the role Stellar should grant when a member clicks the verify button.
/verification setrole [role]
This role cannot be a managed role, cannot have the Administrator permission, and cannot be positioned higher than your own highest role. This step must be completed before setting the channel.
2

Post the verification embed

Send the verification embed to a channel with a custom message. An optional button emoji can be specified.
/verification setchannel [channel] [message]
/verification setchannel [channel] [message] [emoji]
If no emoji is provided, Stellar uses ✅ by default. The channel must be a text channel.
3

Enable the verification system

Turn verification on once the role and channel are configured.
/verification toggle
Both the role and the channel embed must be set before you can enable the system.
4

Confirm your configuration

Review your settings to make sure everything is in order.
/verification config

Commands

/verification setrole [role]

Sets the role Stellar grants to a member when they click the verify button. Must be run before /verification setchannel.
/verification setrole @Verified
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)

/verification setchannel [channel] [message] [emoji?]

Posts the verification embed into the specified text channel. The message parameter is the body text displayed inside the embed. The emoji parameter is optional — if omitted, the button displays ✅.
/verification setchannel #verify Click the button below to access the server.
/verification setchannel #verify Click to verify! 🔒
Running this command again will replace the existing verification embed with a new one.

/verification toggle

Enables or disables the verification system. Both a role and a channel embed must be configured before you can turn it on. Toggles the current state each time it is called.
/verification toggle

/verification config

Displays the current verification configuration, including whether the system is enabled, the verification message ID, and the assigned role.
/verification config
Last modified on May 6, 2026