📖 About
This bot verifies that a Discord user owns an email address with a specific domain (e.g., verify [email protected] emails). This is useful for servers that need to restrict access to verified members only, such as:
- University/College servers - Verify students with
.edu emails
- Company servers - Verify employees with corporate emails
- Organization servers - Verify members with organization emails
How it works:
- User clicks a verification button
- A popup asks for their email address
- A 6-digit verification code is sent to the email (with a Resend code button if it doesn't arrive)
- User enters the code to receive the verified role
🚀 Usage
Invite the Bot
Use this link to invite the bot to your server:
Quick Setup
The fastest way: run /setup — a guided wizard that creates the verified role for you (or uses your existing roles), configures email domains, and posts the verification message. Then run /testmail to confirm email delivery.
Prefer manual setup?
- Invite the bot using the link above
- Add a default role:
/role add @Verified (given to all verified users)
- Add allowed domains:
/domain add @university.edu (use @*.edu for all .edu domains)
- Create a verification button: run
/button "Click to Verify" in your verification channel (or pass channel: to post elsewhere)
- Done! Users can now verify themselves
Advanced: Domain-Specific Roles
You can assign different roles based on which email domain the user verifies with:
/domainrole add domain:@staff.company.com role:@Staff
/domainrole add domain:@*.edu role:@Student
Users will receive their domain-specific roles plus any default roles you've configured.
📝 Commands
👤 User Commands
| Command | Description |
|---|
/verify | Start the email verification process |
/data delete-user | Delete your verification data and remove verified status |
👥 Role Configuration
| Command | Description |
|---|
/role add <role> | Add a default role given to all verified users |
/role remove <role> | Remove a role from the default roles list |
/role list | View all default roles |
/role unverified [role] | Set or view the optional role for unverified members |
🎭 Domain-Specific Roles
Assign different roles based on email domain:
| Command | Description |
|---|
/domainrole add <domain> <role> | Add a role for a specific email domain |
/domainrole remove <domain> <role> | Remove a role from a domain |
/domainrole list | View all domain-role mappings |
/domainrole clear <domain> | Remove all roles for a domain |
💡 Example: /domainrole add @*.edu @Student gives the Student role to anyone with a .edu email
📧 Domain Management
| Command | Description |
|---|
/domain add <domains> | Add allowed email domains (supports * wildcard) |
/domain remove <domains> | Remove allowed domains |
/domain list | View all allowed domains |
/domain clear | Remove all allowed domains |
💡 Wildcard Example: Use @*.edu to allow any .edu email address
🚫 Blacklist Management
| Command | Description |
|---|
/blacklist add <patterns> | Block email patterns (supports * wildcard) |
/blacklist remove <patterns> | Unblock patterns |
/blacklist list | View all blacklisted entries |
/blacklist clear | Remove all blacklist entries |
💡 Wildcard Examples: *@tempmail.* blocks all tempmail domains, *spam* blocks emails containing "spam"
⚙️ Settings
| Command | Description |
|---|
/settings language <lang> | Change the bot's language |
/settings log-channel [channel] | Set or disable the verification log channel |
/settings verify-message [message] | Set or reset custom message in verification emails |
/settings auto-verify <enable> | Auto-prompt new members to verify on join |
/settings auto-unverified <enable> | Auto-assign unverified role to new members |
🛡️ Moderation & Setup
| Command | Description |
|---|
/setup | Guided setup wizard (verified role, created for you if you like → optional unverified role → domains → verification channel) |
/button <buttontext> [channel] | Create a verification button embed (defaults to the current channel) |
/testmail <email> | Send a test verification email to check delivery & spam placement |
/manualverify <user> <email> | Manually verify a user without email confirmation |
/set_error_notify | Configure where error notifications are sent |
📊 Information
| Command | Description |
|---|
/status | View bot configuration, statistics, and check for issues |
/help | Show setup instructions and command overview |
⚠️ Data Management
| Command | Description |
|---|
/data delete-user | Delete your personal verification data |
/data delete-server | Delete all server data and remove the bot |
⚠️ Note: Most commands require administrator permissions
Important: Role Hierarchy
The EmailBot role must be higher in the role hierarchy than the verified and unverified roles, otherwise you'll get a Can't find roles. Please contact the admin! error.
🐳 Self Hosting
If you want to self-host the bot, you have two options: Docker (recommended) or Manual Installation.
💖 Enjoying the bot? If you find this project useful, please consider buying me a pizza to support ongoing development!
Docker (Recommended)
The easiest way to self-host is using Docker with the pre-built image.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
