> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melonly.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Roles

> Configure automated role assignment and management for your Discord server.

***

## What are Roles?

The Roles section allows you to automate role assignment based on member activity or actions.
These roles help your staff quickly identify member status.

You can enable or disable each role type depending on how your server operates.

***

## Available Roles

| Role                   | When it is assigned                      |
| ---------------------- | ---------------------------------------- |
| On Shift               | Given while a member is on shift         |
| On Break               | Given while a member is on break         |
| LOA                    | Given while a member is on leave         |
| LOA Submission Mention | Pinged when a member submits an LOA      |
| Voter                  | Given to users who vote in the directory |

***

## Required Discord Permissions

For Melonly to manage roles correctly, the Melonly Bot must have the proper Discord permissions and role hierarchy.

| Requirement      | Description                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------- |
| Manage Roles     | Melonly must have the Manage Roles permission enabled in your server.                       |
| Role Positioning | The Melonly Bot's role must be placed **above** every role you want it to assign or remove. |

If these requirements are not met, Melonly will not be able to update member roles.

***

## How Roles Work

When a member performs an action such as starting a shift, going on break, or submitting an LOA, Melonly automatically updates their roles in Discord.

This ensures your staff always know who is active, or unavailable.

<Frame caption="Role Configuration">
  <img className="block" src="https://mintcdn.com/melonly/Fbfg13vLjw28H9od/images/Dashboard/DiscordIntegration/rolesimg.png?fit=max&auto=format&n=Fbfg13vLjw28H9od&q=85&s=546f6011fa1ad4dd66bb6058b2311e02" alt="" style={{ borderRadius: '0.75rem' }} width="1906" height="937" data-path="images/Dashboard/DiscordIntegration/rolesimg.png" />
</Frame>

***

<Card title="Need help?" icon="headset" href="https://melonly.xyz/discord">
  Still have questions? Join our Discord server for support from the Melonly Team.
</Card>