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

# Network Moderation

> Shared moderation across a linked group of servers

The Network Moderation cog allows a group of servers to share a common ban list and apply moderation actions across only those servers, without affecting all bot-joined guilds.

## What is a Network

A network is a named group of guilds. Guilds join a network by invitation. The network owner can manage the network and apply network-wide moderation actions. Bans applied at the network level are shared across all member guilds.

## Command Groups

### `/network management`

| Command                              | Description                                                                                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `/network management create`         | Creates a new network. The invoking guild becomes the first member and the creator becomes the network owner.                               |
| `/network management invite`         | Generates a 24-hour join token for another guild to use when joining the network.                                                           |
| `/network management join`           | Joins an existing network using a valid invite token.                                                                                       |
| `/network management leave`          | Removes the invoking guild from the network.                                                                                                |
| `/network management disband`        | Permanently disbands the network and removes all member guilds. Network owner or bot owner only.                                            |
| `/network management transfer_owner` | Transfers network ownership to another user. Current owner or bot owner only.                                                               |
| `/network management transfer_main`  | Transfers the designated main server of the network to another member guild.                                                                |
| `/network management list`           | Lists all guilds currently in the network, including operator assignments.                                                                  |
| `/network management operator`       | Manages operators (users or main-server roles) allowed to run network moderation commands. Actions: `add`, `remove`, `list`.                |
| `/network management owner`          | Manages co-owners for this network (secondary owners with elevated privileges).                                                             |
| `/network management log`            | Sets or clears the channel in the main server used for network moderation logs.                                                             |
| `/network management request_log`    | Sets or clears the channel for `/network moderation requestban` approval messages. Mirrors to the global `REQUEST_LOG_CHANNEL_ID` when set. |
| `/network management appeal_link`    | Sets or clears the ban appeal link used in network punishment DMs.                                                                          |

### `/network moderation`

| Command                          | Description                                                    |
| -------------------------------- | -------------------------------------------------------------- |
| `/network moderation ban`        | Bans a user from every guild in the network.                   |
| `/network moderation softban`    | Softbans a user across every guild in the network.             |
| `/network moderation kick`       | Kicks a user from every guild in the network.                  |
| `/network moderation timeout`    | Times out a user in every guild in the network.                |
| `/network moderation untimeout`  | Removes a timeout from a user in every guild in the network.   |
| `/network moderation unban`      | Unbans a user from every guild in the network.                 |
| `/network moderation massban`    | Bans multiple users across every guild in the network.         |
| `/network moderation status`     | Shows the network moderation status and ban record for a user. |
| `/network moderation requestban` | Submits a ban request for network-level approval.              |
| `/network moderation quarantine` | Quarantines a user across every guild in the network.          |
| `/network moderation sync_bans`  | Re-applies all active network bans across every linked server. |

## Ban Sync

When a network ban is applied, it is propagated to all member guilds. Per-network and per-guild exception lists are respected during sync. Guilds can also be individually excluded from network enforcement.

## Permission Requirements

Network management commands require the network owner or bot owner permission. Network moderation commands require the network owner, a network operator, a globally trusted user, or a bot owner.