> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quarkybot.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Set Up AutoMod Rules and Event Logging with Quarky
> Set up Quarky's AutoMod to automatically filter messages for links, mentions, sensitive info, and more — with full logging of every triggered rule.
Quarky's AutoMod goes beyond Discord's native content filtering, giving you finer control over what gets blocked and how violations are handled. Rules are evaluated before a message is posted, so filtered content never appears in any channel. You can create up to 25 rules, each with its own type, action, and optional configuration.
## Set up AutoMod
Begin by running `/admin-mod auto setup` in your server. In the setup panel, select any **allowed roles** that should be immune to AutoMod rules and choose the **log channel** where AutoMod alerts will be sent.
Click the **Rules** button in the setup panel. This opens the full AutoMod rule manager, where you can define new rules, edit existing ones, and control their behavior.
Click **Add** to create your first AutoMod rule. You will be prompted to select the rule **type** and the **action** that should occur when it is triggered.
For this example, choose the **Everyone & Here Ping Filter** rule type and set the action to a **5-minute timeout**. You may choose other actions depending on your moderation needs.
To add another AutoMod rule, click **Add** again. For this second rule, select the **Username Mention Restriction** rule type to block mentions of specific users.
Rules like Username Mention Restriction require additional configuration. Click **Config** to open a modal where you can enter a **comma-separated list of User IDs** and optionally provide a custom rule name.
After entering the User IDs, you’ll see both rules listed in the panel. You can create up to **25 AutoMod rules** of any type with the Premium Tier. Make sure all required values are filled — rule cards turn red when information is missing.
## Available rules
The following rule types are available when building your AutoMod configuration. Rules marked with a parameter require you to fill in a value via the **Config** button.
| Rule | Description | Parameter |
| ------------------------------------------ | ----------------------------------------------------------- | ----------------------------------------------------------------- |
| **Max Mentions (Role & User) Per Message** | Blocks messages that contain too many role or user mentions | **Max Mentions** — maximum allowed per message (up to 30) |
| **Username Mention Restriction** | Prevents anyone from mentioning specific users | **User IDs List** — comma-separated user IDs to protect (up to 3) |
| **Role Mention Restriction** | Prevents anyone from mentioning specific roles | **Role IDs List** — comma-separated role IDs to protect (up to 3) |
| **Everyone & Here Ping Filter** | Blocks messages containing `@everyone` or `@here` | — |
| Rule | Description |
| -------------------------- | ------------------------------------------------------ |
| **All Links Filter** | Blocks messages containing any URL |
| **YouTube Links Filter** | Blocks messages containing YouTube links |
| **Twitch Links Filter** | Blocks messages containing Twitch links |
| **TikTok Links Filter** | Blocks messages containing TikTok links |
| **Discord Invites Filter** | Blocks messages containing Discord server invite links |
| Rule | Description | Parameter |
| --------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------- |
| **Email Address Filter** | Blocks messages containing email addresses | — |
| **IP Address Filter** | Blocks messages containing IP addresses | — |
| **One Word Length Filter** | Blocks messages with any word exceeding a set character count | **Max Word Length** — maximum allowed characters per word |
| **Non-English Characters Filter** | Blocks messages containing non-English characters | — |
This rule list is updated continuously as new AutoMod features are added to Quarky.
## Logging
When AutoMod blocks a message, it sends an alert to the log channel you configured during setup. Each alert includes details about which rule was triggered, the offending content, and the action taken.
To change your log channel at any time, re-run `/admin-mod auto setup` and select a new channel.
Use a private, staff-only channel for AutoMod logs so your moderation activity stays out of view from general members.