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

# Guild Tag System

> Automatically grant roles and send notification messages when members add your server clan/guild tag to their username.

# Guild Tag Tracking

<Badge variant="pro">Tier 2: Pro</Badge>

> Reward community members who support your server by adding your guild tag / clan tag to their Discord display name, with auto-role sync and custom thank-you alerts.

***

## Command Overview

| Command     | Aliases             | Syntax                               | Description                                            | Permissions   |
| :---------- | :------------------ | :----------------------------------- | :----------------------------------------------------- | :------------ |
| `.guildtag` | `gtag`, `servertag` | `.guildtag <subcommand> [arguments]` | Configure guild tag tracking, sync, and notifications. | Administrator |

***

## Subcommands Reference

| Subcommand    | Syntax                                    | Description                                                          | Example                                                               |
| :------------ | :---------------------------------------- | :------------------------------------------------------------------- | :-------------------------------------------------------------------- |
| `set`         | `.guildtag set <@role\|roleId>`           | Sets the role automatically given to members carrying the server tag | `.guildtag set @GuildTag`                                             |
| `sync`        | `.guildtag sync`                          | Mass-syncs the tag role to all existing server members with the tag  | `.guildtag sync`                                                      |
| `channel`     | `.guildtag channel <#channel\|channelId>` | Sets the notification channel for tag announcements                  | `.guildtag channel #tag-logs`                                         |
| `message`     | `.guildtag message {content}`             | Sets the thank-you message sent when a member adds the tag           | `.guildtag message {user} thanks for supporting us by wearing {tag}!` |
| `testmessage` | `.guildtag testmessage`                   | Sends a test preview of the guild tag message                        | `.guildtag testmessage`                                               |
| `config`      | `.guildtag config`                        | Displays the current guild tag configuration                         | `.guildtag config`                                                    |
| `reset`       | `.guildtag reset`                         | Resets all guild tag tracking configurations                         | `.guildtag reset`                                                     |

***

## Setup Examples

<Tabs>
  <Tab title="Configure Tag Role">
    ```bash theme={null} theme={null}
    .guildtag set @ClanMember
    ```
  </Tab>

  <Tab title="Set Channel & Message">
    ```bash theme={null} theme={null}
    .guildtag channel #announcements
    .guildtag message Thanks {user} for repping the clan tag! Enjoy your special role.
    .guildtag testmessage
    ```
  </Tab>

  <Tab title="Sync & Verify">
    ```bash theme={null} theme={null}
    .guildtag sync
    .guildtag config
    ```
  </Tab>
</Tabs>