Skip to main content
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

CommandDescription
/network management createCreates a new network. The invoking guild becomes the first member and the creator becomes the network owner.
/network management inviteGenerates a 24-hour join token for another guild to use when joining the network.
/network management joinJoins an existing network using a valid invite token.
/network management leaveRemoves the invoking guild from the network.
/network management disbandPermanently disbands the network and removes all member guilds. Network owner or bot owner only.
/network management transfer_ownerTransfers network ownership to another user. Current owner or bot owner only.
/network management transfer_mainTransfers the designated main server of the network to another member guild.
/network management listLists all guilds currently in the network, including operator assignments.
/network management operatorManages operators (users or main-server roles) allowed to run network moderation commands. Actions: add, remove, list.
/network management ownerManages co-owners for this network (secondary owners with elevated privileges).
/network management logSets or clears the channel in the main server used for network moderation logs.
/network management request_logSets or clears the channel for /network moderation requestban approval messages. Mirrors to the global REQUEST_LOG_CHANNEL_ID when set.
/network management appeal_linkSets or clears the ban appeal link used in network punishment DMs.

/network moderation

CommandDescription
/network moderation banBans a user from every guild in the network.
/network moderation softbanSoftbans a user across every guild in the network.
/network moderation kickKicks a user from every guild in the network.
/network moderation timeoutTimes out a user in every guild in the network.
/network moderation untimeoutRemoves a timeout from a user in every guild in the network.
/network moderation unbanUnbans a user from every guild in the network.
/network moderation massbanBans multiple users across every guild in the network.
/network moderation statusShows the network moderation status and ban record for a user.
/network moderation requestbanSubmits a ban request for network-level approval.
/network moderation quarantineQuarantines a user across every guild in the network.
/network moderation sync_bansRe-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.