Guide

Setup & Configuration

Welcome & goodbye messages

Welcome messages greet new members when they join your server, helping them feel welcome and guiding them to the right channels. Configure welcome messages from the dashboard under Settings > Welcome. You can customize the message content, choose the channel where it is posted, and optionally include an image or embed.

The message content supports template variables: {user} (mentions the new member), {server} (your server name), {memberCount} (current member count), and {age} (account age in days). For example, a welcome message might say: 'Welcome to {server}, {user}! You are member #{memberCount}.'

Goodbye messages work similarly and are configured from the same page. These are triggered when a member leaves the server. You can customize the message and choose whether to show the member's join date and how long they were in the server.

Both welcome and goodbye messages can be sent as embeds with custom colors and thumbnails. You can also enable a welcome image — a generated graphic showing the member's avatar and a welcome banner. The image template can be customized with your server's branding colors and logo.

Verification setup

The verification system helps protect your server from raids and bots by requiring new members to complete a verification step before gaining full access. Configure it from the dashboard under Settings > Verification.

To set up verification, first choose the verification channel where new members will be prompted. Then select the unverified role (assigned to new members on join) and the verified role (assigned after verification passes). Members start with the unverified role and are prompted in the verification channel to complete a challenge.

Guardexa supports several verification methods: button verification (click a button to verify, fastest method), CAPTCHA verification (solve a simple image challenge, good for bot protection), and question verification (answer a server-specific question, most secure). You can require multiple methods for high-security servers.

When a member successfully verifies, the unverified role is removed and the verified role is assigned. Failed verification attempts are logged, and members who fail multiple times can be automatically kicked or banned. All verification statistics are available from the dashboard.

Logging configuration

Guardexa's logging system records server events to dedicated channels, giving you a complete audit trail. Configure logging channels from the dashboard under Settings > Logging. Each event type can be assigned to a different channel, or you can consolidate them into a single channel.

The available log types include: Message Logs (edits, deletions, and bulk deletions), Member Logs (joins, leaves, and role changes), Moderation Logs (all moderator actions with case details), Voice Logs (channel joins, leaves, and moves), Server Logs (channel creation, deletion, and settings changes), and Infraction Logs (warning thresholds, auto-moderation actions).

Each log entry includes detailed metadata. For example, a message deletion log shows the message content, the channel it was in, who deleted it (the member or a moderator), and a timestamp. Deleted message logs include the full message content even if it was long, so you always have evidence if needed.

Log messages can be customized — you can choose between concise one-line logs or detailed embed logs with color coding by event type. Log retention is unlimited, but you can set an auto-prune duration from the dashboard to automatically clean up old log entries.

Auto-role assignment

Auto-roles are roles that are automatically assigned to members when they join your server. This is useful for giving new members a default role, granting booster perks, or assigning verified roles after verification. Configure auto-roles from the dashboard under Settings > Auto Roles.

To add an auto-role, click 'Add Role' and select the role to assign and the trigger condition. Available triggers include: on join (assigned immediately when a member joins), on verification (assigned after the member completes verification), and on boost (assigned when a member boosts the server).

You can set multiple auto-roles with different triggers and conditions. For example, new members might receive a 'Member' role on join, a 'Verified' role after verification, and a 'Booster' role when they boost. Roles are assigned in the order you configure them, and the bot respects Discord's role hierarchy — it cannot assign a role higher than its own highest role.

Use /autorole to view all configured auto-roles from within Discord. You can temporarily disable specific auto-roles without deleting them, which is useful during maintenance or events. The dashboard shows assignment statistics so you can see how many members have received each role.