Docs

Set up AgVerify

AgVerify gives members a role after they verify their age with AgeVerif. Watch the setup guide for the short version.

Before you start

1Add AgVerify to your server

  1. Press Add to Discord.
  2. Under Add to server, pick your server and press Continue.
  3. Leave all four permissions checked and press Authorize.
Discord's Add to server screen with Your Server picked and the Continue button marked
Discord's permission screen listing Manage Roles, View Channels, Send Messages and Read Message History, with Authorize marked

2Move AgVerify's role up

When AgVerify joins, Discord gives it a role called AgVerify. Discord only lets a bot give roles that are below its own role.

  1. Open Server Settings → Roles.
  2. Drag the AgVerify role above your verified role.
  3. Press Save Changes.
Discord's Roles page with the AgVerify role moved above Age Verified and the Save Changes button marked

Don't skip this step. If AgVerify's role is below the verified role, members pass the age check but then see Couldn't give your role.

3Choose the role in the dashboard

  1. Open the dashboard and sign in with Discord.
  2. Pick your server, then open Verification.
  3. Under Role to assign, choose your verified role. Verification turns on by itself.
  4. Press Save verification.
The Role to assign list in the dashboard, with Age Verified marked and other roles shown as not assignable
The dashboard Verification page with Age Verified chosen, verification turned on and Save verification marked
The checklist turns green once the role can be given.

A role marked (not assignable) is above AgVerify's role, or belongs to a bot, boost or subscription. Go back to step 2, or pick a normal role.

4Post the verification message

  1. Open Message.
  2. Under Post in channel, pick your channel.
  3. Change the message if you like. It uses Discord markdown, which the formatting bar can add for you. Type {role} to show your verified role.
  4. For a box with a color, title and images, switch Style to Embed. You can also give the Verify Age button an emoji or a new label.
  5. Press Post to Discord, then Post message.
The dashboard Message page scrolled to the end of the message and the button fields, with Post to Discord marked
The verification message in a Discord channel with a Verify Age button

Each post adds a new message, and old messages stay. You can also post from Discord with /agverify msg.

5What members see

  1. They press Verify Age. Discord asks before opening the link, and they press Visit site.
  2. AgeVerif opens and they pick a way to check their age, such as a selfie or a credit card.
  3. On Age Verified!, saving is optional. Continue without saving is fine.
  4. AgeVerif shows what it shares, and they press Allow.
  5. They sign in with Discord and press Authorize, so AgVerify knows which account gets the role.
  6. They see Verification complete ✅ and get the role right away.

Selfie, Yoti and AgeKey only pass members aged 23 or older, or 25 in the UK. Members aged 18 to 22 should choose Credit Card, PayPal or AnonymAGE. Methods vary by country.

AgeVerif's list of ways to verify: Selfie, Credit Card, PayPal Account, AnonymAGE, Yoti and AgeKey
AgeVerif shows the options available in the member's country.
AgeVerif's Age Verified screen with Continue without saving marked
AgeVerif's share screen listing country and state, age threshold and assurance level, and expiration, with Allow marked
AgeVerif shares the country, age result and expiry date.
Discord's sign-in screen for AgVerify asking for username, avatar and banner, with Authorize marked
Discord sign-in only shares their username, avatar and banner.
A member's Discord profile showing the new Age Verified role

AgVerify never receives photos, ID documents, names or birth dates. AgeVerif only tells it whether the member passed and the age that was confirmed. See the Privacy Policy.

Lock your 18+ channels

AgVerify only gives the role. To hide 18+ channels from members who haven't verified, make them private:

  1. Right-click the channel and choose Edit Channel.
  2. Open Permissions and turn on Private Channel.
  3. Press Add members or roles, choose your verified role and press Done.

You can do the same on a whole category with Edit Category. Keep your verification channel open to everyone, so new members can reach the Verify Age button.

Check that it works

Press Verify Age yourself and go through the steps. You should get the role, and the result shows up on the dashboard's Logs page. If you see Couldn't give your role, go back to step 2.

With Block reused verifications on, one AgeVerif check works for one Discord account. Testing it again on a second account shows Already used.

Good to know

Optional settings

Block reused verifications

On the Verification page. It refuses the role when the same AgeVerif check was already used by another account in your server. When it's off, a reused check is allowed and noted in the log.

Log channel

On the Logs page. AgVerify posts each result in a channel you choose, so it needs View Channel and Send Messages there. The dashboard also keeps its own log for 30 days, even with the log channel off.

Hide link previews

On the Message page, for plain text. It stops Discord from adding the repeated AgeVerif preview cards under your message. Embeds never get them.

Embed style

On the Message page. An embed needs Embed Links in that channel. If AgVerify doesn't have it there, the page tells you before you post.

Pause verification

Turn off Enable age verification on the Verification page. Members keep their roles, and new verifications stop until you turn it back on.

Slash commands

Most need Manage Server or Administrator.

CommandWhat it does
/agverify setroleChoose the role given after verification. If AgVerify can't give it, it tells you what to fix.
/agverify msgPost a message with a Verify Age button in a channel. Works after the role is set.
/agverify statusShow the current settings.
/agverify setlogChoose the log channel.
/agverify logoffTurn off logging.
/agverify removeTurn off verification. Unlike pausing, it also clears stored verification records and the dashboard log.
/agverify buttonGet the Verify Age button. Only you can see it. Anyone can use this.
/agverify linkGet the verification link. Anyone can use this.

Troubleshooting

What members might see

Couldn't give your role

The member passed, but AgVerify couldn't give the role. Usually AgVerify's role is below the verified role, or it lost Manage Roles. Fix it with step 2, then ask the member to verify again.

Verification not configured

No role has been chosen for this server yet. Finish step 3.

Verification not accepted

AgeVerif didn't confirm the member is 18 or older, so no role was given. If the member is 18 to 22, they may have used Selfie, Yoti or AgeKey, which need 23 or older (step 5). Ask them to verify again with Credit Card, PayPal or AnonymAGE.

Already used

This AgeVerif check was already used by a different Discord account in your server. It only appears when Block reused verifications is on.

Session expired, Session invalid or Link already used

Each verification link works once and only for a few minutes. Ask the member to press Verify Age in Discord again and finish in the same browser.

Already verified ✅

The member already has the role.

What admins might see

My server isn't in the dashboard

You need Manage Server or Administrator in that server. Sign in with the Discord account that has it.

I can't choose my role

The role is above AgVerify's role, belongs to a bot, boost or subscription, or AgVerify is missing Manage Roles. Fix it in Discord with step 2, then refresh the dashboard.

Post to Discord is greyed out

Turn on verification and choose a role first (step 3).

The message or log won't post

AgVerify needs View Channel and Send Messages in that channel. Check the channel's Permissions settings, or pick another channel.

The log channel says Needs attention

The channel was deleted, or AgVerify lost View Channel or Send Messages there. Choose a new channel on the Logs page.

Need help?

Open Help in the dashboard to send us a message. Include your server name and what you or the member saw.

Last updated November 19, 2026