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

# Predefined Reasons

> Create a library of reusable reason texts that appear as autocomplete suggestions when running staff commands.

**Predefined Reasons** save your team from retyping the same explanations every time they run a `/staff` command. Set up reasons like "Inactivity" or "Failed Trial Period" once, and they'll surface as autocomplete suggestions whenever a reason field is required.

<Note>
  Staff are never restricted to the predefined list. Typing a custom reason that isn't suggested is still allowed.
</Note>

***

<h2 id="manage">
  Managing Reasons
</h2>

You can add, view, and delete your predefined reasons using the following command, which shows up an interactive panel.

<Badge color="red" size="sm">User: Manage Server</Badge>

<Tabs>
  <Tab title="Command" icon="code-simple">
    ```text Command theme={null}
    /config reasons
    ```
  </Tab>

  <Tab title="Visual Output" icon="image">
    <img src="https://mintcdn.com/nocturneidle/77VOh113ntdql3qI/images/Config-Reasons.png?fit=max&auto=format&n=77VOh113ntdql3qI&q=85&s=9145edcf658f3cc58af2991e5c470e0e" alt="Config Reasons" title="Config Reasons" className="mx-auto" style={{ width:"80%" }} width="640" height="287" data-path="images/Config-Reasons.png" />
  </Tab>
</Tabs>

The panel displays the following components:

* A **green <kbd>Add Reason</kbd>** which opens up a modal which allows you to input a label as well as the actual content.
* A **red <kbd>Delete a Reason</kbd> button** which opens up a modal to allow you to delete a specific predefined reason.
* A **grey <kbd>View All Reasons</kbd> button** which lists all reasons, including the labels and description.
* A **<kbd>View / Edit</kbd> select menu** from which you can choose an already set reason and edit it.

***

<h3 id="panel">
  How the Interactive Panel Works
</h3>

Upon running the command, Nocturne will present you with two buttons:

* **<kbd>Add Reason</kbd>** button
  * Clicking this opens a Discord Modal where you can construct your reason.
  * You have to provide a **Label**, which is unique and will be of a maximum length of 25 characters. It is not used as a part of the predefined reasons, but rather it is for internal management.
  * You have to provide the **Content**, which is the actual reason that gets autocompleted. This is what the users see, and the log messages show. This can be a maximum of 100 characters.

<Warning>
  Due to Discord's Autocomplete limitation, the content can only be a maximum of 100 characters.
</Warning>

<Info>
  Only the **Reason Content** appears in the `/staff` command's autocomplete suggestions. Labels are a management convenience only and are never shown to the person running the command during autocomplete. The autocomplete search also matches against labels internally, so typing a label name (e.g. `Inactivity`) will still surface the matching reason's content as a suggestion.
</Info>

<img src="https://mintcdn.com/nocturneidle/77VOh113ntdql3qI/images/Config-Reasons-Add.png?fit=max&auto=format&n=77VOh113ntdql3qI&q=85&s=a64137b9e1f66fadbf61ca9cc23ae2d1" alt="Config Reasons: Add" title="Config Reasons: Add" className="mx-auto" style={{ width:"50%" }} width="467" height="437" data-path="images/Config-Reasons-Add.png" />

* **<kbd>Delete a Reason</kbd>** button
  * Clicking this opens a Discord Modal which will contain a select menu with all of your predefined reasons.
  * You have to select one and submit. On submission, the chosen predefined reason will be deleted.

<img src="https://mintcdn.com/nocturneidle/77VOh113ntdql3qI/images/Config-Reasons-Delete.png?fit=max&auto=format&n=77VOh113ntdql3qI&q=85&s=8faf45657a9d32c9b35be5e1fed13412" alt="Config Reasons: Delete" title="Config Reasons: Delete" className="mx-auto" style={{ width:"55%" }} width="467" height="322" data-path="images/Config-Reasons-Delete.png" />

* **<kbd>View All Reasons</kbd>** button
  * Clicking this shows a follow-up message containing all the reasons configured in your server.

<img src="https://mintcdn.com/nocturneidle/77VOh113ntdql3qI/images/Config-Reasons-View-All.png?fit=max&auto=format&n=77VOh113ntdql3qI&q=85&s=b0b461356c34dc04d0ee821ae7c47a8c" alt="Config Reasons: View All" title="Config Reasons: View All" className="mx-auto" style={{ width:"65%" }} width="491" height="210" data-path="images/Config-Reasons-View-All.png" />

* **<kbd>View / Edit</kbd>** select menu
  * This select menu lists all the predefined reasons in your server.
  * Selecting one of the options shows a Discord Modal where you can edit the corresponding reason.

<img src="https://mintcdn.com/nocturneidle/77VOh113ntdql3qI/images/Config-Reasons-Edit.png?fit=max&auto=format&n=77VOh113ntdql3qI&q=85&s=719c7a13c20386c639dfb586f39dbb93" alt="Config Reasons: Edit" title="Config Reasons: Edit" className="mx-auto" style={{ width:"50%" }} width="462" height="437" data-path="images/Config-Reasons-Edit.png" />
