> ## 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.

# Server Tag

> Reward members who represent your server's clan tag next to their name on Discord.

# Server Tag

> Reward members who represent your server's clan tag next to their name on Discord.

## Overview

Automatically assigns roles when members equip your server's Discord clan tag, and revokes them when they remove it. Supports custom award and revoke messages with per-channel overrides.

<Info>
  Requires your server to have a Discord clan tag configured (Server Settings → Clan). Requires **Manage Server**.
</Info>

*Aliases: `;clan`, `;st`, `;ct`*

***

## Enable & Disable

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;tag enable
    ```

    *Alias: `;tag on`*

    Activates tag reward tracking for this server.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;tag enable
    ```

    Activates tag reward tracking for this server.
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;tag disable
    ```

    *Alias: `;tag off`*

    Deactivates tag reward tracking. Existing roles are not removed.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;tag disable
    ```

    Deactivates tag reward tracking. Existing roles are not removed.
  </Tab>
</Tabs>

***

## Notification Channel

Sets the default channel for **both** the award and revoke messages. Override each individually with `;tag message channel` and `;tag revoke channel`.

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;tag channel #channel
    ```

    Sets the default channel for all tag notifications.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;tag channel #tag-log
    ```

    Sets the default channel for all tag notifications.
  </Tab>
</Tabs>

***

## Award Message

Sent when a member starts representing the tag.

<AccordionGroup>
  <Accordion title="Set message">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag message (text)
        ```

        *Alias: `;tag embed (text)`*

        Sets and enables the award message. Supports TagScript variables.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag message {user.mention} is now repping our tag!
        ```

        Sets and enables the award message. Supports TagScript variables.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Enable / Disable">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag message enable
        ```

        *Alias: `;tag message on`*

        Enables the award message without changing its content.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag message enable
        ```

        Enables the award message without changing its content.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag message disable
        ```

        *Alias: `;tag message off`*

        Disables the award message without clearing it.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag message disable
        ```

        Disables the award message without clearing it.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Set channel">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag message channel #channel
        ```

        Override the channel for award messages specifically.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag message channel #tag-awards
        ```

        Override the channel for award messages specifically.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="View / Clear">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag message view
        ```

        *Alias: `;tag message test`*

        Preview the current award message.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag message view
        ```

        Preview the current award message.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag message clear
        ```

        *Alias: `;tag message remove`*

        Clears the award message and disables it.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag message clear
        ```

        Clears the award message and disables it.
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

***

## Revoke Message

Sent when a member removes the tag.

<AccordionGroup>
  <Accordion title="Set message">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag revoke (text)
        ```

        Sets and enables the revoke message. Supports TagScript variables.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag revoke {user.mention} is no longer repping our tag.
        ```

        Sets and enables the revoke message. Supports TagScript variables.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Enable / Disable">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag revoke enable
        ```

        *Alias: `;tag revoke on`*

        Enables the revoke message without changing its content.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag revoke enable
        ```

        Enables the revoke message without changing its content.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag revoke disable
        ```

        *Alias: `;tag revoke off`*

        Disables the revoke message without clearing it.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag revoke disable
        ```

        Disables the revoke message without clearing it.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Set channel">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag revoke channel #channel
        ```

        Override the channel for revoke messages specifically.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag revoke channel #tag-log
        ```

        Override the channel for revoke messages specifically.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="View / Clear">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag revoke view
        ```

        *Alias: `;tag revoke test`*

        Preview the current revoke message.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag revoke view
        ```

        Preview the current revoke message.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag revoke clear
        ```

        *Alias: `;tag revoke remove`*

        Clears the revoke message and disables it.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag revoke clear
        ```

        Clears the revoke message and disables it.
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

***

## Reward Roles

Roles assigned when a member starts representing the tag. Revoked when they remove it.

*Alias: `;tag role`*

<AccordionGroup>
  <Accordion title="Add a role">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag reward add @role
        ```

        Adds a role to the reward list.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag reward add @Tag Rep
        ```

        Adds a role to the reward list.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Remove a role">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag reward remove @role
        ```

        *Alias: `;tag reward delete @role`*

        Removes a role from the reward list.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag reward remove @Tag Rep
        ```

        Removes a role from the reward list.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="View / Clear">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag reward view
        ```

        Lists all configured reward roles.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag reward view
        ```

        Lists all configured reward roles.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag reward clear
        ```

        Removes all reward roles at once.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag reward clear
        ```

        Removes all reward roles at once.
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

***

## Ignore List

Exclude specific members or roles from receiving tag rewards.

*Aliases: `;tag blacklist`, `;tag bl`*

<AccordionGroup>
  <Accordion title="Ignore a member">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag ignore @member
        ```

        Prevents a member from receiving tag rewards.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag ignore @wanderer
        ```

        Prevents a member from receiving tag rewards.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag ignore remove @member
        ```

        *Alias: `;tag ignore delete @member`*

        Re-allows a member to receive tag rewards.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag ignore remove @wanderer
        ```

        Re-allows a member to receive tag rewards.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag ignore view
        ```

        *Alias: `;tag ignore list`*

        Lists all ignored members.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag ignore view
        ```

        Lists all ignored members.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag ignore clear
        ```

        Clears the member ignore list.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag ignore clear
        ```

        Clears the member ignore list.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Ignore a role">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag ignore role @role
        ```

        Prevents all members with this role from receiving tag rewards.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag ignore role @Staff
        ```

        Prevents all members with this role from receiving tag rewards.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag ignore role remove @role
        ```

        *Alias: `;tag ignore role delete @role`*

        Re-allows members with this role to receive tag rewards.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag ignore role remove @Staff
        ```

        Re-allows members with this role to receive tag rewards.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag ignore role view
        ```

        *Alias: `;tag ignore role list`*

        Lists all ignored roles.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag ignore role view
        ```

        Lists all ignored roles.
      </Tab>
    </Tabs>

    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;tag ignore role clear
        ```

        Clears the role ignore list.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;tag ignore role clear
        ```

        Clears the role ignore list.
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>

***

## Settings & Reset

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;tag settings
    ```

    *Aliases: `;tag config`, `;tag cfg`*

    Shows a summary of the current tag configuration: enabled state, channel, message status, revoke message status, and reward roles.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;tag settings
    ```

    Shows a summary of the current tag configuration: enabled state, channel, message status, revoke message status, and reward roles.
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;tag reset
    ```

    Wipes all tag configuration for this server including reward roles and ignore lists.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;tag reset
    ```

    Wipes all tag configuration for this server including reward roles and ignore lists.
  </Tab>
</Tabs>

***

## Variables

Messages support TagScript variables. See the [Variables](/resources/variables) page for all available placeholders.