Verification

Keep bots and raids out. New members press a button, type a code from a picture, or answer a few questions before they can chat.

Verification makes new members prove they're real before they can see the rest of your server. Your bot posts a panel with a Verify button. New members press it and, depending on how you set it up, they're let straight in, type a code from a picture only they can see, or answer a few questions that the bot or your staff check. Once they pass, the bot gives them your Verified roles. Verification is free for every bot.

The Discord verification bot page gives a shorter tour of what Verification can do.

The verify panel in #verify with its Verify and Help buttons, and the private code picture Tom gets after pressing Verify

What your members will see

Before you start

You need:

  • Your bot in your Discord server. See Invite Your Bot if it isn't yet.
  • A Verified role, like Member. Your bot's own role must be above it, with Manage Roles turned on.
  • A channel for the panel, like #verify. Everyone should be able to see it. In it, your bot needs View Channel, Send Messages and Embed Links.
  • Your other channels hidden from @everyone and shown to the Verified role. Verification gives the role; Discord's channel permissions decide what the role can see.

Some settings need more permissions:

Setting Your bot needs
Kicking members (wrong tries, time, raids) Kick Members
Banning members Ban Members
Timing members out after too many tries Timeout Members
Pausing invites during a raid lock Manage Server

Set up verification

  1. 1

    Turn on Verification

    Open Verification in your bot's dashboard and press Enable at the top right.

    The top of the Verification page with Enabled, the server menu, Reset to Default and Docs marked
    • A Enable turns Verification on. It adds the /verification commands, the Verify member right click command, and the events Verification needs.
    • B The server you're setting up. Every Verification setting belongs to one server (its roles, its channels and its panel), so pick the server first. The page shows the server's icon and name on the settings you're changing.
    • C Reset to Default puts every setting back to how a new Verification starts. The panel channel and the roles stay.
    • D Docs opens this page.

    Still using the old Verification module? The page offers to move your settings across. See Moving from the old Verification.

  2. 2

    Pick the Verified role and the panel channel

    On the Verify tab, pick the roles members get in Roles they get, and the channel in Where the panel goes.

  3. 3

    Save

    A bar pops up at the bottom of the page. Press Save Changes. Your bot restarts to pick up the changes, which takes about 20 seconds.

    The Unsaved changes bar with Save Changes marked
  4. 4

    Post the panel

    Press Post the panel on the Verify tab, or run /verification panel in your server. To try it out, press Verify with a second Discord account.

    The setup strip with what to do next, the Setup guide link and the steps marked
    • A What to do next. Once everything is done, it says Verification is ready.
    • B The steps, ticked off as you do them. Press one to go to it.

The tabs

Everything else is on up to seven tabs. The preview on the right shows what members see in Discord for the tab you're on.

The tabs: Verify, Code, Checks, Limits, Raids and Logs
  • Verify: how members verify, the roles they get, the panel and the Help button.
  • Code: the code picture and the rules before it. Only shown while members verify by typing a code.
  • Questions: the form, the right answers and staff review. Only shown while members verify by answering questions.
  • Checks: who has to verify, Discord's rules screening, account age and profile pictures.
  • Limits: wrong tries, the time to verify, and members who come back.
  • Raids: locking verification when a lot of accounts join at once.
  • Logs: the log channel and the staff roles.

Verify

How members verify

How members verify, with Press a button, Type a code and Answer questions

Pick one way for this server:

Way What members do Good for
Press a button Press Verify and they're in Stopping bots that only join and post
Type a code Press Verify, see a code in a picture only they can see, press Type the code and type it back. Capitals don't matter Stopping bots that can press buttons. It starts on this one
Answer questions Press Verify and fill in a short form. The bot checks the right answers, or your staff read them and press Approve or Deny Servers that want to know who's joining

Whichever you pick, the checks on the Checks tab run first, and the Limits tab applies.

Roles they get

Roles they get, with Give them and Take this role away marked
  • A Give them: the Verified roles, given once a member verifies. Your bot can only give roles below its own; the page says Can't give on a role it can't.
  • B Take this role away: an Unverified role, given when a member joins and taken away once they verify. Leave it empty if you don't use one. It can't be one of the roles they get.

Where the panel goes

Where the panel goes, with the panel channel and Post the panel marked
  • A Panel channel: where the panel is posted. New members should see this channel and nothing else until they verify.
  • B Post the panel: posts it in the channel with the Verify button. Once it's there, the button says Post it again: after you change the panel, press it to update the panel where it is.

Save before you post: posting uses your saved settings. Right after a save, the button waits about 20 seconds for your bot to restart.

The verify panel

When the panel is posted, with the message, Edit message, the variables, the Verify button, its emoji and the button colour marked
  • A Message: a box for each text part of the panel, like the heading, how it works and the footer.
  • B Edit message opens the Message Builder, for pictures, separators and the layout.
  • C The variables this message fills in. Press one to copy it. {verify_steps} is how to verify in this server, as numbered steps for the way you picked.
  • D Verify button: the words on the button, and Its emoji. Leave the emoji empty for none.
  • E Button colour: Green, Blurple, Grey or Red.

The bot adds the buttons under the panel itself, so you don't add them in the Message Builder. The panel's buttons keep working for as long as the panel is there.

Help button

Help button switched on, with the switch and the button words marked
  • A Add a Help button: a second button on the panel. Pressing it shows how to verify, privately. Useful when members get stuck on the code or the questions.
  • B Help button: the words on it.

The When someone presses Help card under it is the reply they get.

Code

This tab shows while members verify by typing a code.

The code picture

The code picture, with the code length, how long it works, the picture, Edit the picture and the button words marked
  • A Code length: from 5 to 8 letters and numbers. It starts at 6. Codes leave out letters and numbers that look alike, like O and 0.
  • B It works for: from 1 to 15 minutes. It starts at 5. After that, the member presses Verify for a new code.
  • C The picture: how the code is drawn. Each member gets a new code every time they press Verify.
  • D Edit the picture opens the Card Studio, to change the colours, the background and the font. Put {verify_code} where the code goes. Back to the default puts the captcha design back.
  • E Button under the picture: the words on the button that opens the box to type the code in. It starts as Type the code.

The code picture is a private reply: only the member who pressed Verify sees it. Each member gets one new code every 20 seconds at most, so pressing Verify over and over can't hold up everyone else. After a wrong code they can press Verify for a new one straight away.

Rules before the code

Rules before the code switched on, with the switch, the rules and the box marked
  • A Show the rules: puts your rules at the top of the form members type the code in, with a box they must tick.
  • B The rules: up to 4,000 characters.
  • C The box: the words beside it, like I've read and accept the rules.

Questions

This tab shows while members verify by answering questions.

The questions

The questions, with three questions, their right answers and Edit the questions marked
  • A Each question, with its right answer, Any answer or Staff read it.
  • B Edit the questions opens the form editor.

The form takes up to 5 fields: text boxes, dropdowns or choices. Each question can have a right answer, and capitals don't matter. Leave it empty to take any answer, like for "How did you find this server?". For a dropdown or choices, type the option's value. It starts with three questions; the third, "Have you read the rules? Type yes", takes yes.

The questions editor with the form title, the questions, a right answer and how the form looks marked

Edit the questions opens the form editor

  • A Form title: the title at the top of the form.
  • B Questions: press one to change it. Add a question adds another, up to 5.
  • C Right answer for the question you picked.
  • D How it looks in Discord, as you change it.

How answers are checked

How answers are checked, with The bot checks the right answers and Staff approve marked
  • A The bot checks the right answers: a member with every answer right is let straight in. A wrong answer counts as a wrong try (Limits tab), and they get When the answer is wrong.
  • B Staff approve: the answers are posted for your staff with Approve and Deny buttons. The member gets their roles once a staff member presses Approve. Approve button and Deny button are the words on them.

While answers wait for the staff, pressing Verify again just says they're with the staff.

Where staff see answers

  • Review channel: where each member's answers are posted, with Approve and Deny. Leave it empty to use the log channel (Logs tab). With neither, answers can't be sent.

Only staff can press Approve and Deny: members with Manage Roles or a staff role (Logs tab).

If denied

  • Then: Nothing, Kick or Ban, for a member whose answers are denied.
  • DM them the result: off to start with. Turn it on to DM members when they're approved or denied. Members with DMs closed just don't get it.
A review post with New answers from Tom, his account age, when he joined, his answers, and the Approve and Deny buttons

What your staff see

Checks

Rules screening

  • Wait for Discord's rules screening: on to start with. Discord's own Rules Screening asks new members to accept your rules when they join. While this is on, verification starts once they've accepted them, and pressing Verify before that tells them to accept the rules first.

Turn Rules Screening on in Discord, in Server Settings > Safety Setup > DM and Spam Protection, or under Onboarding.

Who has to verify

Who has to verify set to Only suspicious accounts, with Everyone, Only suspicious accounts and the three checks marked
  • A Everyone: every new member presses Verify. It starts on this one.
  • B Only suspicious accounts: accounts that look fine get the Verified roles as soon as they join, and only the others verify.
  • C An account looks suspicious when: switch on the checks you want.
    • The account is newer than a number of days. It starts at 7.
    • No profile picture: they still have Discord's default picture.
    • AutoMod flagged their name: AutoMod held back their name or server tag in this server.

Account age

Account age and Profile picture, with the days, If it's too new, the profile picture switch and If they have none marked
  • A Discord account at least: how many days old a member's Discord account must be to verify, up to 365. It starts at 0, which lets any account verify.
  • B If it's too new:
    • Ask them to come back later: they're told when they can verify.
    • Kick.
    • Let them in when old enough: they finish verifying now and get their roles by themselves once the account is old enough, up to 90 days later.

Profile picture

  • C Needs a profile picture: checked when they press Verify. Accounts still on Discord's default picture are often made in bulk.
  • D If they have none: Ask them to add one, or Kick.

Members who skip verification

  • Skip roles: members with one of these roles never have to verify, like staff, or bots you add by hand. Leave it empty so everyone verifies. Bots that join are always skipped.

Limits

Wrong answers

Wrong answers, Time to verify and Members who come back, with the tries, Then, the wait, the time switch, They have, the warning and When they come back marked
  • A Wrong tries allowed: how many wrong codes or answers someone gets, up to 10. It starts at 3.
  • B Then: what happens when they run out.
    • Wait before trying again: they can try again after a wait, from 1 minute to 7 days. It starts at 10 minutes.
    • Time out: a Discord timeout for that long.
    • Kick.

Staff can clear someone's tries and wait with /verification reset.

Time to verify

  • C Remove members who don't verify in time: off to start with. The clock starts when they join (after rules screening, while that's on).
  • D They have: from 1 minute to 7 days. It starts at 30 minutes. Then: Kick or Ban.
  • E DM a warning this long before: a DM before the time runs out, saying where to verify. Leave it empty for no warning DM. Members with DMs closed won't get it.

Members who come back

  • F When they come back: for a verified member who leaves and joins again within 90 days.
    • Give their roles back: they get the Verified roles straight away. It starts on this one.
    • Verify again.

Raids

Lock verification during a raid

The Raids tab, with Lock it by itself, the joins, the time, Lock it for, Pause invites too, New joins and Ping this role marked

When a lot of accounts join at once, verification locks for a while so nobody can verify. Members who press Verify during a lock are told to try again later. When the lock ends, verification opens again by itself.

  • A Lock it by itself: off to start with.
  • B When this many join, from 2 to 100 accounts, Within 10 seconds to 1 hour. It starts at 10 accounts within 1 minute.
  • C Lock it for: from 1 minute to 24 hours. It starts at 30 minutes.

Staff can lock and open verification by hand with /verification lockdown.

Pause invites while locked

  • D Pause invites too: also turns on Discord's own Pause Invites, so no more accounts can join during the lock. Your bot needs Manage Server. Discord pauses invites for 24 hours at most.

During a lock

  • E New joins: Verify as normal once the lock ends, or Kick new accounts newer than a number of days. It starts at 7.

Who gets pinged

  • F Ping this role: pinged in the log channel when a lock starts. Leave it empty to ping nobody.

Discord has its own Raid Protection too, in Server Settings > Safety Setup. It works well alongside this.

Logs

Log channel

Log channel and Staff roles, with the channel, Log every wrong answer and the staff roles marked
  • A Log channel: who verified and how, who got it wrong, who was removed, and every raid lock. Leave it empty for no log.
  • B Log every wrong answer: off, a wrong answer is only logged when someone runs out of tries.

Staff roles

  • C Staff roles: members with one of these roles can use /verification and Verify member, and approve answers. Members with Manage Roles always can. Leave it empty to keep it to Manage Roles.

The bot's messages

Every message Verification sends has its own card on the tab it belongs to. Each card has the message, Edit message to open the Message Builder, and the variables it fills in. Messages to the member are private replies only they can see, except the ones marked DM. DMs are off until you turn on the setting that sends them.

The When someone is verified card, with the message, Edit message and the variables marked
Tab Message When it's sent
Verify When the panel is posted The panel, in the panel channel
Verify When someone presses Help They press Help on the panel
Verify When someone is verified They're in
Verify When they're already verified They press Verify but already have the Verified role
Verify When something goes wrong The bot couldn't let them in. Most often, its role is below the Verified role. {verify_problem} says why
Code When they get their code The code picture, with the Type the code button
Code When the answer is wrong The code (or a quiz answer) is wrong and they have tries left
Code When the code has run out They type a code after it stopped working
Code When they ask for codes too fast They press Verify again within 20 seconds of getting a code. It tells them to use the code they got
Code When the picture can't be drawn The bot is drawing too many code pictures at once. They press Verify again in a few seconds
Questions When someone sends answers Posted for the staff, with Approve and Deny
Questions When answers are approved The staff post, once someone presses Approve
Questions When answers are denied The staff post, once someone presses Deny
Questions When answers are sent Their answers are with the staff
Questions When answers are already with the staff They press Verify while their answers wait
Questions When they're approved (DM) The staff approve them, while DM them the result is on
Questions When they're denied (DM) The staff deny them, while DM them the result is on
Checks When the account is too new Their account is younger than the account age
Checks When they have no profile picture A profile picture is needed and they have none
Checks When they haven't accepted the rules They press Verify before accepting Discord's Rules Screening
Checks When a new account is held They passed, and get in by themselves once their account is old enough
Checks When a held account presses again They press Verify again while they wait
Limits When they're removed Just before they're kicked for too many tries, or for their account
Limits When they've had too many tries They run out of tries and have to wait, or are timed out
Limits When they're warned before removal (DM) Before the time to verify runs out, while a warning is set
Raids When verification is paused They press Verify during a raid lock
Raids When a raid lock starts In the log channel, pinging the role you picked
Raids When a raid lock ends In the log channel
Logs When someone is verified In the log channel, with how they got in
Logs When someone gets it wrong In the log channel when they run out of tries (and on every wrong answer, while that's on)
Logs When someone is removed In the log channel when Verification kicks or bans someone
Logs When staff take verification away In the log channel after /verification remove
Logs When staff check someone The private reply to /verification status

Commands

The verification commands, with /verification and its 6 subcommands, Verify member, Settings and one subcommand marked
  • A /verification: press 6 subcommands to see them all. Each subcommand is its own command.
  • B Verify member: right click a member, Apps, Verify member.
  • C Settings opens the command in the builder. The switch next to it turns the command on or off.
  • D A subcommand: its switch turns it on or off, and Edit opens it in the builder.
Command What it does
/verification panel Post the verify panel, or update the one that is there. channel posts it somewhere else
/verification approve Verify a member by hand
/verification remove Take a member's Verified roles away
/verification reset Clear a member's wrong tries and wait
/verification status See whether a member is verified and how, privately
/verification lockdown on pauses verification during a raid, off opens it again
Verify member Right click a member to verify them by hand

Every command is for staff: members with Manage Roles or a staff role (Logs tab). Anyone else who runs one is told it's for staff. To hide the commands from members in Discord, set it per role in Server Settings > Integrations.

Events

Verification is made of ordinary builder blocks. Open an event to see how it works, or add your own blocks.

The six verification events, with Open in builder, the switch and Show variable names marked
  • Member Joined skips bots, waits for Discord's rules screening when it's on, and starts verification for everyone else.
  • Accepted the Rules starts verification for members who just accepted the server's rules, while Wait for Discord's rules screening is on.
  • Start gives returning members their roles back, counts joins for the raid lock, lets trusted accounts straight in, gives the Unverified role and starts the time to verify.
  • Verify Them is the one place a member is let in: it gives the Verified roles, takes the Unverified role, stops their timers, keeps when and how they got in, and logs it.
  • Post the Panel posts the panel in its channel, or updates the one that is there. It holds what the Verify and Help buttons do.
  • Member Left stops a leaving member's timers, clears their tries and answers, and forgets them 90 days later unless they come back.
  • A Open in builder opens the event in the Command Builder.
  • B The switch turns the event on or off.
  • C Show variable names shows the variable behind each setting on the page, if you want to use them in your own commands.

Start, Verify Them and Post the Panel run when another block triggers them, with Trigger a Custom Event: the panel's buttons, the commands and the page all use them.

The settings on this page are read by the events' blocks, so changing a setting never changes the events. If you change an event and want the original back, use its reset on the Verification page.

Message variables

Every Verification message can use these. Each message card lists the ones it fills in.

Variable What it shows
{server} The server's name
{user_name} The member's name
{user_displayName} The member's display name
{verify_steps} How to verify in this server, as numbered steps for its way of verifying
{verify_member} The member, as a mention (logs and staff messages)
{verify_member_name} The member's name (logs and staff messages)
{verify_member_id} The member's ID
{verify_account_age} How old their account is, in days
{verify_joined} When they joined. Use it as <t:{verify_joined}:R>
{verify_how} How they got in, like "the code" or "staff"
{verify_by} The staff member who let them in or decided their answers, as a mention
{verify_by_line} " ยท let in by @name" when staff let them in, empty otherwise
{verify_tries} How many wrong tries they've had
{verify_tries_left} How many tries they have left
{verify_tries_word} "try" or "tries"
{verify_tries_limit} How many tries they get
{verify_wait_until} When they can try again. Use it as <t:{verify_wait_until}:R>
{verify_locked_until} When a raid lock ends. Use it as <t:{verify_locked_until}:R>
{verify_hold_until} When a held account gets in. Use it as <t:{verify_hold_until}:R>
{verify_limit_at} When the time to verify runs out. Use it as <t:{verify_limit_at}:t>
{verify_channel} The panel's channel, as a mention
{verify_expires_minutes} How many minutes a code works for
{verify_type_label} The words on the Type the code button
{verify_code_wait} When they can get a new code. Use it as <t:{verify_code_wait}:R>
{verify_reason} Why they were removed
{verify_raid_reason} Why a raid lock started
{verify_invites_line} "New invites are paused." when invites are paused with the lock, empty otherwise
{verify_alert} The role pinged when a raid lock starts, as a mention
{verify_answers} Their answers, each under its question
{verify_problem} What went wrong
{verify_status} "Not verified", or when and how they verified (status reply)
{verify_rules} Whether they've accepted the server's rules (status reply)
{verify_review} Whether their answers are waiting for the staff (status reply)
{user_check_reason} Why their account didn't pass, like "Your account is 2 days old. It needs to be 7 days old."
{user_check_wait} When their account will pass. Use it as <t:{user_check_wait}:R>

Every limit

What Limit
Code length 5 to 8 letters and numbers, 6 to start
How long a code works 1 to 15 minutes, 5 to start
Questions 5 fields
Wrong tries Up to 10, 3 to start
Wait or timeout after too many tries 1 minute to 7 days
Time to verify 1 minute to 7 days
Account age Up to 365 days
Holding a new account Up to 90 days
Raid lock 2 to 100 joins within 10 seconds to 1 hour, locked for 1 minute to 24 hours
Code pictures 60 a minute per bot, one every 20 seconds per member
Members who come back Within 90 days

Every feature is free for every bot. On free bots, the module's messages have a small Made with BotGhost line under them. Premium bots don't.

What Verification keeps

  • Only member IDs, how many wrong tries someone has had, and when and how they verified. No IP addresses, no device details and nothing from outside Discord.
  • Answers to the questions are posted for your staff, and Verification doesn't keep them.
  • A member's record is forgotten 90 days after they leave, unless they come back.

Moving from the old Verification

If your bot still has the old Verification module on, the page shows Your bot still uses the old Verification at the top.

  1. Press Move my settings. The channel, the role, the panel, the button, the log channel, the success message, the tries and the time limit move into the server that has the old Verified role. The old module is switched off, so the two never both kick.
  2. Press Save Changes, then Post the panel.
  3. Delete the old panel in Discord yourself: the old module never kept where it was.

Once nothing needs them, the page offers to delete the old module's leftover variables. Turning the new Verification on while the old one is still on asks to switch the old one off first.

Good to know

  • Each server has its own settings: roles, channels, the panel, messages and every check. Pick the server at the top of the page before you change them.
  • Bots that join are always skipped.
  • After an update to Verification, the page shows an Update button. Your own changes to the events and messages are kept.

Common questions

Members verify but don't get the role

Check that your bot's role is above the Verified roles in Server Settings > Roles, and has Manage Roles. The member gets When something goes wrong, saying why.

Members can still see every channel

Verification only gives roles. Hide your channels from @everyone and allow the Verified role in each channel's (or category's) permissions.

Nothing happens when members press Verify

Check your bot is online, and that the panel was posted after your last save: press Post it again on the Verify tab.

The code picture doesn't show

Lots of people may be verifying at once. They get Lots of people are verifying and can press Verify again in a few seconds for a new code.

Members are told to accept the rules first

Wait for Discord's rules screening is on (Checks tab), and they haven't accepted your server's rules yet. They accept them from the banner at the bottom of their screen. If your server doesn't use Rules Screening, turn the setting off.