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

# Connect Your Server to Prowl's Global Chat Network

> Prowl Global Chat links your server's channel to a shared network, letting members from different servers chat together in real time.

Global Chat is one of Prowl's most unique features — it bridges the gap between Discord servers by connecting a channel on your server to a shared, cross-server chat network. Instead of your community existing in isolation, your members can strike up conversations with people from entirely different servers, all without leaving Discord.

## What Is Global Chat?

When you link a channel to the Prowl Global Chat network, every message sent in that channel is relayed to every other linked channel across all participating servers. Replies flow back the same way — making it feel like one large, shared conversation happening simultaneously across multiple communities.

Messages are prefixed with the sender's username and server name so participants always know who they're talking to:

```text theme={null}
Username (ServerName): Hey everyone!
```

<Info>
  Global Chat is completely free and requires no special bot permissions beyond the ability to read and send messages in the linked channel.
</Info>

## Linking a Channel

You link and unlink channels using slash commands.

### Link

```text theme={null}
/globalchat link
```

Run this in the channel you want to connect to the Global Chat network. Prowl will create a webhook in the channel and begin relaying messages.

<Note>
  You need the **Manage Server** permission to link a channel.
</Note>

### Unlink

```text theme={null}
/globalchat unlink
```

Run this in a linked channel to disconnect it from the Global Chat network. After unlinking, your channel remains intact with its message history — Prowl simply stops relaying messages.

### Check Status

```text theme={null}
/globalchat info
```

Shows whether the current channel is linked to the Global Chat network and displays relevant details.

## All Global Chat Commands

| Command              | Description                                    | Permission    |
| -------------------- | ---------------------------------------------- | ------------- |
| `/globalchat link`   | Link the current channel to the global network | Manage Server |
| `/globalchat unlink` | Unlink the current channel                     | Manage Server |
| `/globalchat info`   | Check global chat status for this channel      | None          |

## How Messages Are Relayed

When a member sends a message in a linked channel:

1. Prowl captures the message content and any attachments
2. The message is forwarded via webhook to every other linked channel across all servers
3. The message is prefixed with `{username} ({servername})` so recipients know who sent it
4. Content is truncated to 1000 characters if it exceeds the limit
5. Attachments are shown as `[attachment]` since they cannot be cross-relayed

<Note>
  All participating servers must have Prowl added. The network connects all linked channels — there is no way to link to specific servers only.
</Note>

## Network Rules

The Global Chat network is shared infrastructure, so Prowl enforces network-wide rules that apply to all participating servers. Messages that violate these rules are automatically removed from all connected channels.

**The network rules prohibit:**

| Rule                | Details                                             |
| ------------------- | --------------------------------------------------- |
| Hate speech & slurs | Any language targeting protected characteristics    |
| NSFW content        | Explicit images, videos, or text                    |
| Spam & flooding     | Repeated messages, excessive mentions, or link spam |
| Doxxing             | Sharing personal information about real individuals |
| Scam links          | Phishing URLs, fake giveaways, or malware           |
| Raiding             | Coordinated disruption of the network               |

<Warning>
  Severe or repeated rule violations can result in your **entire server** being removed from the Global Chat network, not just the individual user. Maintain active moderation in your linked channel.
</Warning>

## Tips for a Great Experience

<CardGroup cols={2}>
  <Card title="Use a Dedicated Channel" icon="message-dots" href="/features/global-chat">
    Always link Global Chat to a purpose-built channel like `#global-chat`. Mixing it with local chat creates a confusing experience for your members.
  </Card>

  <Card title="Set Channel Topic" icon="pen-to-square" href="/features/global-chat">
    Use the channel topic to explain what Global Chat is. Something like "Chat with members from other Prowl servers in real time!" goes a long way.
  </Card>

  <Card title="Appoint Moderators" icon="shield-halved" href="/configuration/permissions">
    Make sure at least one moderator actively watches the Global Chat channel, especially if your server is large. Quick moderation keeps things tidy.
  </Card>

  <Card title="Enable Slowmode" icon="clock" href="/features/global-chat">
    Enabling Discord's built-in slowmode (5–10 seconds) on your linked channel prevents flooding and keeps conversations readable.
  </Card>
</CardGroup>

<Warning>
  If your linked channel does not have slowmode enabled, you have a greater chance of being ratelimited by Prowl, while ratelimited your messages will not send to other servers however you will still have the ability to receive messages. The duration of the ratelimit is exponential starting at 30 seconds to 1 day.
</Warning>