Verification Setup

This guide covers configuring member verification for new users, including verification types, custom prompts, and role handling.

What Verification Does

• Blocks new users from full access until they verify.

• Assigns roles automatically on completion.

• Supports Discord-only and hCaptcha verification flows.

Requirements

• Bot permissions: Manage Roles, Manage Channels, Read Message History, Send Messages.

• A dedicated verification channel (recommended).

Setup

Run:

/verification setup

You will be prompted for:

• Verification type: discord or hcaptcha

• Verification channel: where the prompt is posted

• Verified role: role assigned after success

• Unverified role: role assigned before verification (optional bot will create if not entered)

• Log channel: where verification logs are posted (optional)

• Auto-kick: optional timeout for unverified users

Verification Types

Discord (Button)

Users click a verification button in the channel then are presented with captcha image. This is the fastest and easiest flow.

hCaptcha

Users are sent a link to complete a captcha in browser for increased security. hCaptcha is managed and paid for by bot developer for now.

Check status with:

/verification hcaptcha_status

Custom Prompts

Use the configuration command to customize prompt text and behavior:

/verification configure

Typical customizations:

• Welcome message text

• Button label text

• Auto-kick timing

• Log channel settings

Status and Diagnostics

/verification status

Shows current config and which channels/roles are active.

/verification diagnostics

Checks permissions, intents, and channel/role access.

Manual Verification

If a user gets stuck:

/verification manual

To resend the prompt:

/verification resend_message

Tips

• Keep the verification channel read-only for unverified members.

• Place the Verified role above general roles in the hierarchy.

• Hide verification channel from those without unverified role.

• Use a log channel to audit verification activity.