Configuration Guide
This guide explains every setting you can configure for AgeVerifier in plain language. It covers what each option does, its default value, whether it's a free or premium feature, and anything to watch out for. You don't need any technical knowledge to follow along — each setting is changed through the bot's slash commands (like /config).
Tip: You can see all of your current settings at any time by running
/config view. Most settings require the * Manage Server* permission.
Free vs. Premium at a glance
Most of AgeVerifier is free. The following features require premium:
- Join Requirements (all the gatekeeping checks, the failure action, and minimum account age)
- Advanced verification modes — ID Verification and Basic + ID. (Website verification, the default, and Basic date-of-birth verification are free.)
- The Verification Page — your customizable web verification page.
- Automated lobby cleanup & kicking — the Clean Lobby Days and Kick on Cleanup settings.
- Reverification — including the reverification roles and the reverify log channel.
- Leave Message — the notification posted when a member leaves.
- Leave Survey — the feedback survey sent to members who leave.
- Verification Button Label — custom text on the verification button.
- Verification Reminder — a DM to members who opened the website verification page but didn't finish.
Everything else described in this guide is available on the free plan. Premium items are marked with 💎 Premium below.
Welcome & System Messages
These are the messages the bot posts automatically at different points. You write the text yourself, and the bot fills in details like the user's name and your server name. You can write the welcome messages for free; note that the leave message is only sent when the premium Send Leave Message feature is enabled, and that the verification button label can only be changed with premium.
| Setting | What it does | Default | Plan |
|---|---|---|---|
| Verification Completed Message | The welcome message posted in your verification-completed channel once a user finishes verifying. It automatically begins with Welcome to {server name} {user}! and then your custom text follows. | Not set | Free |
| Server Join Message | The very first message a new user sees when they join, posted in your lobby channel. It automatically begins with Welcome {user}! followed by your custom text. | Not set | Free |
| Server Leave Message | The message sent when a user leaves your server. Requires the premium Send Leave Message feature to actually be delivered. | Not set | 💎 Premium |
| Verification Button Label | 💎 The text on the verification button itself — the green button members click to start verifying. Maximum 80 characters (Discord's limit). When it is not set, the button reads Start Age Verification!. | Not set | 💎 Premium |
Channels
Channels tell the bot where to post things. You point each of these at a channel in your server. None of them are set until you choose one. All are free except the Reverify Age Log, which is part of the premium reverification feature.
| Setting | What it does | Plan |
|---|---|---|
| Invite Log | Where the bot records invite information (who invited whom). | Free |
| Verification Completed Channel | The channel where the "verification completed" welcome message is posted after a user is verified. | Free |
| Server Join Channel (Lobby) | Your lobby — the first place new members land. This is where the welcome message appears and where the verification process begins, so it's where new users interact with the bot. | Free |
| Age Log | Where lobby activity is logged. ⚠️ This channel must be hidden from regular users. If it is visible to them, the bot will leave your server. | Free |
| Approval Channel | Where your staff approve verifications. This channel should be hidden from regular users. | Free |
| Verification Failure Log | Where failed verification attempts are recorded. Should be hidden from regular users. | Free |
| Reverify Age Log | Where re-verification activity is logged. If left unset, it falls back to your regular Age Log. ⚠️ This channel must be hidden from regular users, or the bot will leave your server. | 💎 Premium |
| Leave Log | Where member departures are recorded. | Free |
Important: The Age Log and Reverify Age Log channels contain sensitive information. If either one is visible to normal members, the bot will automatically leave your server to protect that data. Always double-check their permissions.
Roles
Roles control what access members get. These settings tell the bot which roles to add or remove at different stages. None of them are set until you configure them. All are free except the Reverification Role, which is part of the premium reverification feature.
| Setting | What it does | Plan |
|---|---|---|
| Verification Add Role | Roles given to a user once they successfully verify. These can also be age roles with their own age ranges — see the section below. | Free |
| Verification Remove Role | Roles taken away from a user once they successfully verify (often used to remove a "lobby" or "unverified" role). | Free |
| Return Remove Role | Roles removed when a user runs the /lobby return command. | Free |
| Server Join Role | Roles added the moment a user joins, and automatically removed once they verify their age. Useful for a temporary "newcomer" role. | Free |
| Auto Update Excluded Roles | Roles that the automatic age-update system should leave alone. Use this to stop the bot from adding or changing roles you'd rather manage yourself. | Free |
| Reverification Role | Roles added to a user when they re-verify their age (e.g. a "Reverified" role). Great for NSFW age gates or servers that added age verification after already having members. | 💎 Premium |
| Approval Ping Role | The role that gets pinged when a user submits a verification and is waiting for staff approval. ⚠️ This does not work with Automatic Verification mode (there's no manual approval step to ping for). | Free |
Age Roles (assigning roles by age)
The Verification Add Role setting can do more than hand out a single "verified" role — it can assign different roles based on how old a member is. When you add a role, you set a minimum age and a maximum age, and the bot gives that role only to members whose age falls inside that range.
For example, you could set up:
- an 18–20 role (minimum 18, maximum 20),
- a 21+ role (minimum 21, maximum 200), and
- a general Verified role (minimum 18, maximum 200) that everyone who verifies receives.
A member is automatically given every role whose range includes their age. When you add an age role, the defaults are a minimum age of 18 and a maximum age of 200 (effectively "no upper limit") unless you specify otherwise.
If a member's age is below the minimum of every age role you've set up, they don't receive any of them — instead the bot treats them as too young for the server and handles them accordingly (for example, kicking them if Autokick Underaged Users is on). Make sure your lowest age role covers the youngest age you actually allow.
If you also turn on Auto Update Age Roles (see General Toggles), the bot keeps these roles accurate over time — for instance moving someone from the 18–20 role into the 21+ role once they get older. Any roles listed under Auto Update Excluded Roles are left untouched by this process.
Verification Modes
You can choose how users prove their age. There are two separate settings: one for first-time Verification and one for Reverification (when an existing user is asked to verify again).
For each, you can pick one of these methods:
| Method | What it means | Plan |
|---|---|---|
| Basic | The user provides their date of birth and age. This is the simplest option. | Free |
| ID Verification | The user verifies using a photo ID (following safe ID-handling procedures). | 💎 Premium |
| All | Offers both — the user can verify by date of birth or ID, whichever they prefer. | 💎 Premium |
| Website | Verification is handled through the online dashboard/website instead of inside Discord. | Free |
Default: New servers start on Website verification. You can switch to Basic for free; ID Verification and All are 💎 premium.
Setup:
/config setupauto always sets Website verification. Manual setup asks you to pick Website or Basic first; skip it to keep your current method. ID Verification and All are set with/config verification_mode.Reverification is 💎 premium and always happens inside Discord, so it can't be set to Website; it defaults to Basic.
Verification Reminder 💎 Premium {#verification-reminder}
Members sometimes open the website verification page, get distracted, and never come back. The verification reminder sends them a DM with their verification link once they've had the page open for the number of minutes you choose, so they can pick up where they left off.
Set it with /config verification_reminder minutes:<minutes>. Default: off. Set it to 0 to turn it off again; the longest delay is 7 days (10080 minutes).
- It only applies when your verification mode is Website.
- Each link is reminded once. Members with closed DMs are skipped silently.
- Members who left the server, or who were verified some other way in the meantime (for example a staff approval that removed their lobby role), aren't reminded.
Join Requirements (Gatekeeping) 💎 Premium
These are optional checks the bot runs on new members as they join. Each one can be turned on or off individually. If a member fails an enabled check, the bot takes the action you've chosen (see Failure Action below). This whole section is a premium feature, and every check is off by default.
| Requirement | What it checks | Plan |
|---|---|---|
| Account Age | Whether the account is old enough. You set the minimum in days (see Minimum Account Age). Very new accounts are a common sign of spam or ban-evasion. | 💎 Premium |
| Has Avatar | Whether the account has a profile picture. Accounts with no avatar are flagged. (If a user recently added an avatar, Discord can take up to ~30 minutes to update, so they may need to wait before rejoining.) | 💎 Premium |
| Mutual Guilds | Whether the account shares at least one other server in common with the bot. Brand-new throwaway accounts usually share none. | 💎 Premium |
| Is Bot | Whether the joining account is an unapproved bot. Bots added by a non-administrator are flagged; bots added by an admin are allowed. | 💎 Premium |
| Has Bans | Whether the account has ban records on file (via the bot's ban-tracking system). | 💎 Premium |
| Require Active Presence | Whether the account is actually online. Accounts that appear offline or invisible are flagged. | 💎 Premium |
| Filter Web-Only Accounts | Flags accounts that are only connected through the web browser client (with no desktop or mobile activity), a pattern often seen with throwaway accounts. | 💎 Premium |
Failure Action
Join Fail Action decides what happens when a member fails one of the checks above:
-
Log Only — Record the failure quietly but let the member in.
-
Kick Member — Remove the member from the server.
-
Quarantine Role 💎 Premium — Let the member in, but give them a quarantine role for a set number of hours. The bot takes the role off again once that time has passed since they joined (it checks every 10 minutes). Set the role and the duration with
/joinguard quarantineor on the dashboard's Join Guard page; the duration defaults to 24 hours and can be up to 720 (30 days). Use the role to limit what quarantined members can see or do, for example by denying it access to your channels.Use a role that's only for quarantine: anyone holding it longer than the duration since they joined has it removed on the next check, including members you gave it to by hand. If no quarantine role is set, or the bot can't give it out (it needs Manage Roles, and the role must be below the bot's highest role), the failure is logged and the member gets in without it.
Minimum Account Age
Minimum Account Age is the number of days an account must exist to pass the Account Age check above. Default: 7 days.
Lobby Cleanup
These settings control the automatic tidying of your lobby (removing members who join but never verify). Automated lobby cleanup is a premium feature.
| Setting | What it does | Default | Plan |
|---|---|---|---|
| Clean Lobby Days | How many days an inactive, unverified member can sit in the lobby before they're removed. Set to 0 to disable. | 0 (disabled) | 💎 Premium |
| Kick On Clean | When cleanup runs, decides whether inactive members are actually kicked from the server (on) or just cleaned up without kicking (off). | On | 💎 Premium |
Approval Message Options
When a user's verification is waiting for staff approval, the bot shows an approval card. These toggles control what information appears on that card, so your staff see exactly what they need to make a decision. All of these are **free **.
| Option | What it shows | Default | Plan |
|---|---|---|---|
| Large Picture | Displays a large version of the user's profile picture. | Off | Free |
| Small Picture | Displays a small profile picture instead (this hides the large one). | On | Free |
| Bans | Shows the user's ban records before you approve. | On | Free |
| Joined At | Shows when the user joined your server. | On | Free |
| Created At | Shows when the user's Discord account was created. | On | Free |
| User ID | Shows the user's account ID number. | On | Free |
| Show Previous Servers | Shows other servers the user has been in. | Off | Free |
| Risk Score | Shows the risk score on website verifications (see below). | On | Free |
| Staff Notes | Shows the newest staff notes on the member (see /notes). | On | Free |
| Legacy Message | Uses the older style of approval message. | Off | Free |
| Debug | Shows a technical debug version of the approval message (mainly for troubleshooting). | Off | Free |
Change these with /config approval_toggles, or on the dashboard.
Reading the Risk Score and Potential Alts
Verifications done on the website (date of birth or ID) carry two extra fields on the approval card. They are there to help your staff decide, not to decide for them: neither one blocks or denies anyone on its own.
Potential Alts lists other accounts that verified from the same IP address or the same device in the last 30 days. Each one is labelled with what it matched on:
| Label | Meaning |
|---|---|
| IP | Verified from the same internet connection. Households, dorms and public Wi-Fi share one. |
| device | Verified from a browser and device that look identical. Phones of the same model can match, so this alone is weak. |
| IP + device | Both match. This is the strongest sign that two accounts belong to the same person. |
Up to 20 accounts are listed. Accounts that left your server still show, and accounts waiting on a GDPR removal never do. Addresses and device details are stored as one-way hashes, so staff only ever see the matching accounts.
Risk Score sums up the signals into one number out of 100, with the reasons listed under it:
| Signal | Points |
|---|---|
| The website flagged a VPN or proxy | +35 |
| An alt matching on IP and device | +40 |
| An alt matching on IP only | +30 |
| An alt matching on device only | +20 |
| Discord account younger than 7 / 30 / 90 days | +25 / +15 / +5 |
Alts count once, for the strongest match, however many there are. The total lands in one of three bands: 🟢 Low (0–29), 🟡 Medium (30–59) and 🔴 High (60–100). A high score is a prompt to take a closer look, for example by asking for ID, and a low score doesn't mean a verification can skip your usual checks. Turn the field off with the Risk Score option above; the Potential Alts list always shows.
Denial Reasons
The Deny button on the approval card asks your staff why. They pick one of your server's denial reasons, or write a one-off custom reason, and the member gets a DM with the reason and its message: what went wrong and what to do next. Members with closed DMs are skipped, and the approval card shows whether the member was told. Denying doesn't kick the member or change their verification record, so they can fix the problem and submit again.
Every server starts with these reasons, which you can edit or remove:
| Reason | What the member is told |
|---|---|
| Age and date of birth don't match | Check both and submit again, with the date of birth as mm/dd/yyyy. |
| Invalid date of birth | Submit again with a valid date as mm/dd/yyyy. |
| Inappropriate profile | Remove the NSFW content from their profile, then submit again. |
| Suspected alternate account | Their account looks linked to another one; contact staff if this is a mistake. |
| Contact staff | The verification needs a closer look; contact staff for the next steps. |
Manage them with /config denial_reasons: list shows them, add and edit open a pop-up, remove deletes one and reset restores the defaults. {user} and {server} in a message are replaced with the member's mention and your server's name. A server can have up to 24 reasons. Free, needs Manage Server.
General Toggles
These are simple on/off switches for major features.
| Toggle | What it does | Default | Plan |
|---|---|---|---|
| Send Join Message | Turns the lobby welcome message on or off for new members. | On | Free |
| Send Verification Completed Message | Turns the "you're verified" welcome message on or off. | On | Free |
| DM Verification Completed Message | Also sends the "you're verified" message to the member's DMs. It works independently of the toggle above, so turning that one off and this one on gives you a DM-only welcome. (Members with DMs closed simply don't receive it.) | Off | Free |
| Automatic Verification | Lets the bot approve verifications automatically instead of requiring a staff member to approve each one. (Note: the Approval Ping Role does not apply while this is on.) | Off | Free |
| Autokick Underaged Users | Automatically removes users who don't meet your server's age requirement. | Off | Free |
| Autokick On Discrepancy | Automatically removes a user when the age they entered doesn't match the date of birth they provided during verification. They're kicked with a message explaining the mismatch and inviting them to appeal to staff. | Off | Free |
| Auto Update Age Roles | Automatically keeps members' age-based roles up to date over time. (Respects the Auto Update Excluded Roles setting.) | Off | Free |
| Ping Owner On Failure | Notifies the server owner when a verification fails. | On | Free |
| Survey | Sends a short survey to members when they leave the server. | Off | 💎 Premium |
| Log Config Changes | Records whenever a setting is changed, so you have a history of who changed what. | On | Free |
| Cleanup Messages | Automatically tidies up the bot's own messages to keep channels clean. | On | Free |
| Send Leave Message | Posts a notification to your leave channel whenever a member leaves the server. | Off | 💎 Premium |
| Kick On Clean | During automated lobby cleanup, kicks inactive members from the server rather than just clearing them. | On | 💎 Premium |
Other defaults worth knowing
- Verification Cooldown — how long a user must wait between verification attempts (set with
/config cooldown). * Default: 5 minutes.* Set it to0to disable the wait entirely.
Need a hand?
Run /config view to see your current settings, and remember that most changes require the Manage Server permission. Anything marked 💎 Premium is part of AgeVerifier's premium features — everything else works on the free plan. When in doubt, start with the defaults — they're designed to be safe for most servers.