# Guild

The Social SDK uses the term **Guild** to represent what everyone else calls a **Discord Server**. Unfortunately, the name can be confusing since a Guild here is simply a Discord Server — nothing more, nothing less.

## What is it?

* **Just a Discord Server:**\
  When you get the list of Guilds, you’re simply retrieving all the Discord servers the local user is a member of. There’s no special or unique meaning behind the term.
* **Limited Server Info:**\
  You can get the server’s **name**, but not its image or icon, through the SDK.
* **Channels Are Included:**\
  Each Guild gives you access to the list of channels the user can see within that server. These channels indicate whether they can be linked to a lobby.

### How Channels and Lobbies Relate

* **Finding Channel IDs:**\
  You can use the Guild’s channels to find the **channel ID** needed to link a lobby to a channel.
* **Linking Lobbies to Channels:**\
  This linking bridges a temporary chat lobby to a persistent server channel, allowing in-game chat to sync with Discord channel conversations.
* **No Lobby Secret Exposure:**\
  The SDK doesn’t provide access to the lobby secret associated with a linked channel. This secret string is required to join a lobby, so the user must share it outside the SDK for you to join.

## Use Case

### Guild Data

* **Player Discord Server Setup:**\
  This data can be used in a Discord integration UI to let players choose their Discord servers and channels to link lobbies to.
* **Channel Visibility & Linking:**\
  Channels expose whether they can be linked to a lobby, letting you filter and present valid chat channels for integration.
* You cannot chat on a channel directly; you chat through lobbies, so to chat on a channel, you would need to be a member of its lobby, if any.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.heathen.group/discordsocial/features/guild.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.