Role Groups

Role groups allow you to organize your Discord roles into logical categories to greatly simplify Marsha configuration.

Access: Dashboard → Settings → Groups

What is a Role Group?

A role group is a collection of Discord roles that you define once and can reuse everywhere in Marsha.

Without role groups:

For each feature, you must individually select @Admin, @Moderator, @Helper, etc. It's repetitive and tedious.

With role groups:

You create a "Staff" group containing @Admin, @Moderator, @Helper. Then, you simply select the "Staff" group in each feature. If you add a new role to the group, it's automatically applied everywhere.

Benefits

Time saving:

Configure once, use everywhere. No need to select the same roles again and again.

Ease of management:

Modify a group and all settings using it are automatically updated.

Clarity:

Groups give clear structure to your role hierarchy.

Consistency:

Ensure the same roles have the same permissions in all features.

Creating a Role Group

Step 1: Access Groups

1. Go to dash.marsha.app
2. Select your server
3. Navigate to Settings → Groups
4. Click "Create Group"

Step 2: Name the Group

Give a descriptive name to your group. The name should be clear and reflect the group's role.

Name examples:

• "Staff" for all team members
• "Moderators" for the moderation team
• "VIP" for premium members
• "Helpers" for assistants
• "Bots" for server bots

Step 3: Select Roles

Check all Discord roles that should be part of this group.

Example for "Staff" group:

• ✅ @Owner
• ✅ @Administrator
• ✅ @Manager

Step 4: Save

Click "Create" or "Apply" to save the group.

Recommended Group Examples

"Staff" Group

Included roles:

• @Owner
• @Administrator
• @Manager
• @Co-Owner

Usage:

Exempt this group from all auto-moderation rules, give them access to all moderation commands, and exclude them from limitations (cooldowns, captcha, etc.).

"Moderators" Group

Included roles:

• @Moderator
• @General Mod
• @Voice Mod
• @Junior Mod

Usage:

Give them access to basic moderation commands (/warn, /mute, /kick), exempt them from less strict auto-mod rules, and allow them to use information commands.

"Helpers" Group

Included roles:

• @Helper
• @Support
• @Assistant

Usage:

Limited access to information commands (/user, /server), exemption from basic auto-mod rules, and ability to use /notes.

"VIP" Group

Included roles:

• @Booster
• @Donor
• @VIP
• @Premium

Usage:

Exemption from certain auto-mod rules (links, emojis), captcha bypass, and slowmode not applied.

"Members" Group

Included roles:

• @Member
• @Verified
• @Active

Usage:

Default roles for the majority of members. Useful for defining rules that apply to normal members.

"Bots" Group

Included roles:

• @Music Bot
• @Utility Bot
• @Moderation Bot
• All your bots

Usage:

Exempt them from all auto-moderation rules, exclude them from logs (to avoid spam), and give them necessary permissions.

Using Role Groups

Once created, your groups appear in all Marsha configurations.

In Auto-Moderation

When you create an auto-moderation rule, you can select groups in Exceptions:

"Exempt group: Staff"

All members with a role from the Staff group will be exempted from this rule.

In Command Permissions

To define who can use a command, select authorized groups.

Example: The /ban command requires the "Staff" or "Moderators" group.

In Anti-Raid

Exempt certain groups from anti-raid actions so they aren't affected during lockdown.

Example: The "Staff" group isn't kicked during a raid.

In Captcha

Exempt groups from captcha verification.

Example: Members who already have the "Verified" role don't re-do the captcha.

In Logs

Exclude groups from logs to reduce noise.

Example: The "Bots" group doesn't appear in message logs.

Modifying a Group

To modify an existing group:

1. Go to Settings → Groups
2. Click on the group you want to modify
3. Add or remove roles
4. Click "Apply"

Important: Modifications are automatically applied everywhere the group is used.

Deleting a Group

To delete a group:

1. Go to Settings → Groups
2. Click the delete icon (🗑️) next to the group
3. Confirm deletion

Warning

If a group is used in configurations (auto-mod rules, permissions, etc.), deleting it will remove those exemptions/permissions. Check before deleting.

Best Practices

Create groups first:

Before configuring auto-moderation, sanctions, etc., create all your role groups first. This will make the rest much faster.

Clear names:

Use explicit names like "Staff", "Moderators", "VIP" rather than "Group1", "Group2".

Logical hierarchy:

Organize your groups from most to least permissions: Staff > Moderators > Helpers > Members.

Don't multiply groups:

3 to 6 groups are usually enough. Too many groups make management complex.

Document your structure:

Note somewhere (in your internal notes) which group has which role and why. Useful for new admins.

Complete Structure Example

Here's an example group structure for a medium server:

"Administration" Group

• @Owner, @Co-Owner, @Admin
• Full access, exempt from everything

"Moderation" Group

• @Moderator, @Voice Mod
• Moderation commands, exempt from auto-mod

"Support" Group

• @Helper, @Guide
• Info commands, notes, exempt from some rules

"Premium" Group

• @Booster, @VIP, @Donor
• Benefits and exemptions

"Members" Group

• @Member, @Verified
• No special exemptions

"Bots" Group

• All bots
• Exempt from auto-mod and logs

Next Steps

• Auto-Moderation: Use groups in rules
• Settings: Other server configurations
• Permissions: Understand the permission system

Essential configuration

Role groups are the first thing to configure in Marsha. They make all subsequent configuration much simpler and faster.