First-Time Setup (Server Owners)
Step 1. Invite VerifyBot
Use the official invite link from the project README:
Step 2. Position the Bot Role
Move the VerifyBot role above any roles it must assign.
Why this matters:
- Discord blocks role assignment when the bot role is lower than target roles.
Step 3. Configure Verification Roles
- Create your public verification role (for example
Verified). - Add it to VerifyBot allowlist with
/addverifyrole. - Confirm with
/listverifyroles.
Step 4. Configure Logs
Set a log target:
- Channel logging:
/setlogs channel:#verify-logs - Webhook logging: use your server webhook target if enabled
Step 5. Choose Verification Mode
- Manual flow:
/verify @member role:Verified - Reaction flow:
/setreactionverify channel:#verify role:Verified emoji:✅
Step 6. Test the Workflow
- Test verification on a non-staff account.
- Confirm role assignment works.
- Confirm logs post correctly.
- Confirm slash commands are visible to moderators.
Quick Validation Checklist
- Bot can see and send messages in verify and log channels.
- Bot role is above verification role(s).
- Verification role is in allowlist.
- Slash commands are synced in server.
- Log target is configured and writable.