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

# Settings

> Configure LOA requirements, duration rules and automatic messages.

***

## What are LOA Settings?

LOA settings control how leave of absence requests work in your server. You can require certain details, set duration limits and customize the messages Melonly sends.

***

## General Settings

<Frame caption="General Settings">
  <img className="block" src="https://mintcdn.com/melonly/L_smx8QqSCk39kYu/images/Dashboard/LOA/gensettingsimg.png?fit=max&auto=format&n=L_smx8QqSCk39kYu&q=85&s=b1e9ac0bef3bae68748fd43325499d28" alt="The LOA general settings" style={{ borderRadius: '0.75rem' }} width="1904" height="932" data-path="images/Dashboard/LOA/gensettingsimg.png" />
</Frame>

| Setting | Description |
| - | - |
| Require Reason | Staff must give a reason when they submit an LOA |
| Require Denial Reason | Reviewers must give a reason when they deny an LOA or extension request. Approval reasons are always optional |
| Require End Date | Staff must give an end date for their LOA |
| Disallow Shifts on Leave of Absence | Staff can't start a shift while on an active LOA |

Click **Copy Request Link** to copy the link staff use to request an LOA.

***

## Duration Settings

<Frame caption="Duration Settings">
  <img className="block" src="https://mintcdn.com/melonly/L_smx8QqSCk39kYu/images/Dashboard/LOA/durationimg.png?fit=max&auto=format&n=L_smx8QqSCk39kYu&q=85&s=edc5fcce938b9a36ecfda0afa8a27664" alt="The LOA duration settings" style={{ borderRadius: '0.75rem' }} width="1907" height="940" data-path="images/Dashboard/LOA/durationimg.png" />
</Frame>

| Setting | Description |
| - | - |
| Submission Cooldown | Days staff must wait after an LOA is approved or denied before they can submit another |
| Minimum Leave of Absence Days | The fewest days an LOA can cover |
| Maximum Leave of Absence Days | The most days an LOA can cover |

Leave a field empty, or set it to 0, to remove that limit.

<Info>
  The On LOA role and LOA channel are set on the [Discord Integration](/Dashboard/discordintegration/home) page.
</Info>

***

## Message Customization

<Frame caption="Message Customization">
  <img className="block" src="https://mintcdn.com/melonly/L_smx8QqSCk39kYu/images/Dashboard/LOA/custommsgimg.png?fit=max&auto=format&n=L_smx8QqSCk39kYu&q=85&s=d7961a8b4ab7765f37a68a34877696cc" alt="The LOA message settings" style={{ borderRadius: '0.75rem' }} width="1910" height="939" data-path="images/Dashboard/LOA/custommsgimg.png" />
</Frame>

### LOA Submission Mention Role

Choose the roles Melonly mentions when someone requests an LOA. This needs a linked Discord server.

### Custom DMs

Customize the DMs Melonly sends to staff during the LOA process. Custom DMs need [Melonly Plus](https://melonly.xyz/plus).

| Message | Sent When |
| - | - |
| LOA Submission DM | Staff submit an LOA request |
| LOA Cancelled DM | Staff cancel their LOA |
| LOA Approved DM | An LOA request is approved |
| LOA Denied DM | An LOA request is denied |

Each message supports variables.

<AccordionGroup>
  <Accordion title="Variables">
    | Variable | Description |
    | - | - |
    | `{reason}` | The reason the staff member gave. In the LOA Denied DM, this is the denial reason |
    | `{loareason}` | The reason the staff member gave. Approved and Denied DMs only |
    | `{reviewreason}` | The reason the reviewer gave for their decision. Approved and Denied DMs only |
    | `{reviewer}` | The user who reviewed the LOA. Approved and Denied DMs only |
    | `{approvereason}` | The reason the reviewer gave for approving. Approved DM only |
    | `{denyreason}` | The reason the LOA was denied. Denied DM only |
    | `{time}` | Short date and time |
    | `{timet}` | Short time |
    | `{timeT}` | Long time |
    | `{timed}` | Short date |
    | `{timeD}` | Long date |
    | `{timef}` | Short date and time |
    | `{timeF}` | Long date and time |
    | `{timeR}` | Relative time |
  </Accordion>
</AccordionGroup>

***

<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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.