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

# Creating Logs

> Use the log form to punish one or more players, add proof, set temporary bans, and apply presets.

***

## The Log Form

The Create New Log form sits at the top of the middle column. The rest of the form opens once you enter a player.

<Frame caption="Create New Log">
  <img className="block" src="https://mintcdn.com/melonly/A1khd4CvHJNzkfPQ/images/Mod-Panel/Logs/form.png?fit=max&auto=format&n=A1khd4CvHJNzkfPQ&q=85&s=f2f25347ca9427ebe41834f94276cead" alt="The Create New Log form with a user, type, and reason" style={{ borderRadius: '0.75rem' }} width="1918" height="989" data-path="images/Mod-Panel/Logs/form.png" />
</Frame>

***

## Creating a Log

<Steps>
  <Step title="Enter the player">
    Type a Roblox username in **User**, or press `Ctrl` + `I` to jump to the field. Press `Tab` to accept a suggestion.
  </Step>

  <Step title="Choose a type">
    Select a log **Type**. Types you don't have permission for are greyed out.
  </Step>

  <Step title="Write a reason">
    Enter a **Reason**. Melonly suggests common reasons as you type; press `Tab` to accept one.
  </Step>

  <Step title="Create the log">
    Click **Create Log** or press `Ctrl` + `Enter`.
  </Step>
</Steps>

<Frame caption="Log types">
  <img className="block" src="https://mintcdn.com/melonly/A1khd4CvHJNzkfPQ/images/Mod-Panel/Logs/types.png?fit=max&auto=format&n=A1khd4CvHJNzkfPQ&q=85&s=dfd0c57dc279b9ca0637231c41336830" alt="The log Type dropdown with Warning, Kick, Ban, Ban Bolo, and Note" style={{ borderRadius: '0.75rem' }} width="1918" height="989" data-path="images/Mod-Panel/Logs/types.png" />
</Frame>

<Tip>
  Made a mistake? Press `Ctrl` + `Z` right after creating a log to reopen it for editing.
</Tip>

Typing a player in **User** also opens their [User Panel](/Modpanel/logs/userpanel), so you can check their history before you log.

### Reason box

The reason box supports a few extras:

* `@` mentions a Melonly user.
* `:` opens an emoji picker, including your Discord server's emojis.
* Links in the reason are clickable on the log.

***

## Logging Multiple Players

You can log several players at once with the same type and reason.

<Frame caption="Multi-user log with a temporary ban">
  <img className="block" src="https://mintcdn.com/melonly/A1khd4CvHJNzkfPQ/images/Mod-Panel/Logs/advanced.png?fit=max&auto=format&n=A1khd4CvHJNzkfPQ&q=85&s=aed1835515088c538fb9938049b89761" alt="The log form with two players, a description, and a temporary ban" style={{ borderRadius: '0.75rem' }} width="1918" height="989" data-path="images/Mod-Panel/Logs/advanced.png" />
</Frame>

<Steps>
  <Step title="Add each player">
    Type a username and press `Enter`. Repeat for each player.
  </Step>

  <Step title="Fill in the log">
    Choose a type and reason as usual. Everything you add applies to every player.
  </Step>

  <Step title="Create the logs">
    Click **Create Log**. Each player gets their own separate log.
  </Step>
</Steps>

***

## Descriptions

Requires [Melonly Plus](https://melonly.xyz/plus).

Click **Add description** to add more detail under the reason. Use it for context, timelines, or clip links. Medal.tv clip links show up as clips on the log.

***

## Temporary Bans

Requires [Melonly Plus](https://melonly.xyz/plus).

When the type is Ban, tick **Temporary Ban** and choose an **Unban Time** (up to 1 year away). Melonly unbans the player automatically, and the log shows when the ban ends.

***

## Proof Images

Requires [Melonly Plus](https://melonly.xyz/plus).

Click **Upload image** or drag images onto the form. You can attach up to 2 PNG or JPEG images.

***

## Punishment Presets

Presets are saved punishments with a name, reason, type, and optional temporary ban length. They require [Melonly Plus](https://melonly.xyz/plus) and are set up under [Dashboard → Panel](/Dashboard/settings#punishment-presets).

<Frame caption="Punishment Presets">
  <img className="block" src="https://mintcdn.com/melonly/A1khd4CvHJNzkfPQ/images/Mod-Panel/Logs/presets.png?fit=max&auto=format&n=A1khd4CvHJNzkfPQ&q=85&s=3a7468b70bb17390703f3e02f7be96ca" alt="The Punishment Presets window listing saved presets" style={{ borderRadius: '0.75rem' }} width="1918" height="989" data-path="images/Mod-Panel/Logs/presets.png" />
</Frame>

<Steps>
  <Step title="Open presets">
    Click the book icon in the **Reason** box, or press `Ctrl` + `P`.
  </Step>

  <Step title="Choose presets">
    Click one or more presets to select them, then click **Select**. Double-click a preset to apply it straight away.
  </Step>

  <Step title="Review and create">
    The reasons are combined, and the type is set to the most severe one you picked. If a Ban preset has a duration, the temporary ban is filled in for you.
  </Step>
</Steps>

Presets for log types you can't use are greyed out.

***

## Resetting Previous Punishments

<Note>
  Requires the Reset previous punishments count permission.
</Note>

When the type is Note, you can tick **Reset previous punishments count**. Logs created after this note start counting previous punishments from zero. See [Previous Punishments](/Modpanel/logs/punishmentlogs#previous-punishments).

***

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