Commands
Infraction Management
Every moderation action in Marsha creates an infraction record. This system allows you to keep a complete trace of all sanctions and member history.
What is an infraction?
An infraction is a permanent record of a moderation action including:
- The sanction type (warn, mute, kick, ban, etc.)
- The sanctioned member
- The moderator who issued it
- The detailed reason
- The timestamp
- The duration (for temporary sanctions)
- Supporting evidence (screenshots, logs)
Infraction Types
| Type | Description | Temporary |
|---|---|---|
| Note | Internal staff note (not a sanction) | No |
| Warn | Official warning | No |
| Mute | Cannot send messages/speak (role) | No |
| Tempmute | Temporary mute (role) | Yes |
| Timeout | Native Discord timeout | Yes |
| Kick | Removed from server | No |
| Ban | Permanently banned | No |
| Tempban | Temporarily banned | Yes |
Viewing Infractions
/infractions list - View history
Displays all infractions for a member or the entire server.
Syntax:
Examples:
You'll see a paginated list with the infraction ID, type, moderator, date, and reason summary.
/infractions get - View details
Displays all details of a specific infraction.
Syntax:
Example:
Details displayed:
The unique ID, sanction type, affected member, issuing moderator, exact date, full reason, duration for temporary sanctions, status (active, expired, or revoked), and attachments if present.
Interactive buttons:
You can modify the reason or duration, add supporting evidence, or delete the infraction directly from this interface.
Managing Infractions
Modifying an infraction
After using /infractions get <id>, click the Edit button to:
Modify the reason:
Add more context, correct typos, add additional violations, or clarify details. All modifications are recorded with timestamp and author.
Manage attachments:
Add screenshots, videos, or audio files as evidence. Supported formats are PNG, JPG, GIF, WEBP, MP4, MOV, WEBM, MP3, WAV, OGG (max 25MB per file).
Modify duration:
For tempbans and tempmutes, you can extend or reduce the duration if necessary.
/infractions delete - Delete an infraction
Permanently deletes an infraction from history.
Syntax:
Example:
Permanent action
Deleted infractions cannot be recovered. The action is recorded in logs, but the original data is lost.
When to delete:
Use this command when the infraction was issued by mistake, when the member was incorrectly identified, or when the situation was resolved following a successful appeal.
/infractions clear - Bulk deletion
Deletes multiple infractions for a member at once.
Syntax:
Examples:
A confirmation shows you the number of infractions that will be deleted before proceeding.
Use cases:
Appeal accepted for all sanctions, fresh start after a long period of good behavior, data cleanup, or GDPR requests.
Advanced Filtering via Dashboard
For advanced search and filtering, use the Web Dashboard.
Filters available on dashboard:
- By date range
- By infraction type
- By moderator
- By member
- By status (active/expired/revoked)
- By keywords in reason
Infraction Lifecycle
Permanent infractions:
Warns, kicks, bans, and notes remain active indefinitely and are always visible in history.
Temporary infractions:
Tempbans, tempmutes, and timeouts are marked "active" until expiration. When time is up, the status automatically changes to "expired", the sanction is lifted, and a log is created.
Revoked infractions:
When you manually lift a sanction with /unban or /unmute, the status changes to "revoked" and the revocation reason is added.
Statistics
/mod-statistics - View statistics
Display moderation statistics for the server or a specific moderator.
Syntax:
Examples:
Statistics include total number of infractions by type, most active moderators, and activity trends.
Configuration
To configure who can view, modify, and delete infractions, visit the Dashboard in Settings → Role Groups.
Next Steps
- Moderation commands: Learn to issue infractions
- Dashboard: Advanced management via web interface
- Permissions: Configure who can manage infractions
Questions?
Need help managing infractions? Join our Discord support server!
