Auto-Roles

Automatically assign roles to new members upon joining your server.

Auto-Roles

The Auto-Role system ensures that every new member is instantly integrated into your community by assigning them one or more roles as soon as they join.

Interactive Configuration

Veronica uses a sophisticated, button-based panel for managing your auto-roles.

1. Open the Panel

   Launch the interactive auto-role manager:

   /autorole
   

   Interactive panel active.
2. Add a Role

   Click the Add Role button. The bot will prompt you to mention the role or provide a Role ID.

3. Security Verification

   If the role you select has Dangerous Permissions, Veronica will issue a warning.

Next Steps

Welcome System

Link roles with your custom greeting messages.

Verification

Use auto-roles as part of your server gatekeeping flow.

Command Reference

Command	Description	Permission
/autorole	Open the interactive management panel	Manage Server
/autorole add	Quickly add a role to the join list	Manage Server
/autorole remove	Remove a role from the join list	Manage Server
/autorole clear	Delete all configured auto-roles	Manage Server

Security Features

Veronica prioritizes your server’s safety with several built-in checks:

• Hierarchy Check: Veronica can only assign roles that are positioned lower than its own highest role in the Discord settings.
• Dangerous Permission Guard: Automaticaly detects and warns against auto-assigning roles with destructive capabilities (e.g., Manage Channels, Kick/Ban).
• Managed Role Protection: Prevents you from auto-assigning roles that belong to other bots or integrations.

Interaction Panel

The /autorole panel displays your current configuration in real-time:

🛡️ Auto-Role Configuration

Current Roles:
- @Member
- @Verified
- @Unassigned

[Add Role] [Remove Role] [Clear All] [Dismiss]

If you have a verification system, use auto-roles to give everyone an “Unverified” role first, then remove it once they complete your process!

Always ensure Veronica has the Manage Roles permission and that its primary role is above the roles you want it to assign.