Docs / stagehand

Captcha Verification

New members can be asked to prove they are human before accessing the server. StageHand sends a **DM** with a short captcha (random letters). When they enter it correctly, the bot assigns a **verified role** you choose. This is useful for reducing raid bots and alt spam without a third-party verification bot.

Prerequisites

  • Bot can DM new members (users with DMs closed will not complete verification until they open DMs or use staff tools).
  • A Verified (or similar) role exists below the bot’s highest role.
  • You have Manage Server or Administrator to configure verification.

Quick start

Option A — Dashboard (recommended)

  1. Open StageHand dashboard → Verification.
  2. Select your server.
  3. Turn verification on.
  4. Choose the role to assign when someone passes.
  5. Save.

Option B — Slash commands

  1. /verification role — pick the role granted after success.
  2. /verification toggle — enable verification for this server.
  3. /verification status — confirm settings.

Done when: A test account (or /verification test from the bot owner) receives the DM flow and gets the role on success.

How it works

  1. A user joins the server.
  2. If verification is enabled, StageHand DMs them instructions and a button/modal captcha.
  3. On correct entry, the configured role is added and they receive a confirmation.
  4. Pending attempts are tracked on the bot host so staff can resend or clear stuck states.

Captcha characters avoid ambiguous glyphs (e.g. no 0 vs O).

Commands

CommandWhoPurpose

/verification toggle

Admin

Enable or disable join verification

/verification role

Admin

Set role granted when verified

/verification status

Admin

Show current settings

/verification resend

Admin

Resend DM to one member or all pending

/verification test

Bot owner

Send yourself a test verification DM


For staff

  • Member didn’t get a DM — DMs disabled, blocked the bot, or joined before verification was enabled. Use /verification resend targeting that member.
  • Role not applied — Bot role must be above the verified role in Server Settings → Roles.
  • Turn off temporarily — /verification toggle off; existing verified members keep their role.

← Command Glossary — StageHandIndexing — Maintain your Forums →