Verification Setup
How to set up a verification gate to protect your server from raids and spam.
Verification Setup#
Verification gates help protect your server by requiring new members to complete a verification step before accessing the rest of the server.
Prerequisites#
- Strelitzia must have Manage Roles permission
- A dedicated verification channel
- A "verified" role that grants access to other channels
- (Optional) An "unverified" role that restricts access until verification
Steps#
-
Create a verified role. Create a role (e.g., "Verified") and configure your channels so only members with this role can see them.
-
(Optional) Create an unverified role. Create a role (e.g., "Unverified") and set your channel permissions so members with this role can only see the verification channel. The bot will assign this role automatically when new members join and remove it when they verify.
-
Set up the verification channel. Create a channel that new members can see but verified members do not need. This is where the verification prompt will appear.
-
Configure in the Dashboard
- Go to the dashboard and select your server
- Navigate to the Verification section
- Select your verification channel, verified role, and optionally the unverified role
- Choose a verification mode (Button or CAPTCHA)
- Set the maximum number of attempts and cooldown duration
- Optionally enable agreement content (rules or terms members must accept)
- Customize the button appearance (label, emoji, and color)
- Save your configuration
-
Post the verification message. After saving, use the Post Message button in the dashboard to send the verification embed to your chosen channel. The dashboard handles creating and posting this message for you.
-
Test it. Join with an alt account or ask a friend to verify the flow works correctly.
Verification Modes#
| Mode | Description |
|---|---|
| Button | Member clicks a button to verify. If agreement content is configured, they are shown the rules first and must click "I Agree" to complete verification. |
| CAPTCHA | Member clicks the verify button, receives a CAPTCHA image, and must type the text from the image correctly. If agreement content is configured, they must also accept the rules after solving the CAPTCHA. |
Agreement Content#
You can require members to read and accept rules or terms before being verified. When Require Agreement is enabled, you can add one or more content blocks, each with an optional title and a body. These are displayed to the member as an ephemeral message after they click the verify button.
Content Display Modes#
The way your agreement content is shown to members depends on the display mode you choose:
| Display Mode | Behavior |
|---|---|
| Fields | Each content block is shown as a field within a single embed. The title becomes the field name. |
| Separate Embeds | Each content block is shown as its own embed. Useful for longer content that needs more space. |
| Combined | All content blocks are merged into a single embed description. Titles are shown in bold above their content. |
Button Customization#
You can customize the appearance of the verify button that is posted in your verification channel:
- Label: The text displayed on the button (default: "Verify")
- Emoji: An emoji shown on the button (supports server custom emojis)
- Color: The button color: green, blurple, red, or gray
Attempt Tracking and Cooldown#
Strelitzia tracks verification attempts for each member. This is especially relevant for CAPTCHA mode where members can answer incorrectly.
- Max Attempts: The number of failed attempts allowed before a member is placed on cooldown (1 to 10, default: 3).
- Cooldown: How long a member must wait after exceeding the maximum attempts (1 to 1440 minutes, default: 30 minutes).
When a member exceeds the maximum attempts, they are flagged and placed on cooldown. They will see a message indicating when they can try again. Flagged attempts are logged to your audit log channel if logging is configured.
Tips#
- Keep the verification channel near the top of your channel list so new members find it easily
- Use CAPTCHA mode for maximum protection against bot raids
- Enable agreement content to ensure new members read your server rules before gaining access
- Review your audit logs periodically to check for flagged verification attempts