# Guild Tag Rewards

With the advent of Guild Tags, those shiny badges next to Discord names, we bring the opportunity to give rewards to those who use your server's guild tag. This allows you to provide benefits (such as priority) to those who represent your server, in exchange for helping to promote your server through Discord.

#### OBJECTIVES

* [Setup the Guild Tag Rewards system](https://docs.elyxir.dev/features/guild-tag-rewards)

<figure><img src="https://3586591898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV42S9VMaNEibIOnrBXoN%2Fuploads%2FN9UV7fLbYtAVyjKgRbNl%2Fimage.png?alt=media&#x26;token=7310ca6b-639a-4697-bd84-9570667803ca" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3586591898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV42S9VMaNEibIOnrBXoN%2Fuploads%2F7wnEWwzF0gPVzBzYV8AW%2Fimage.png?alt=media&#x26;token=9ae470f5-7337-47bc-947b-4edc3e9184ee" alt=""><figcaption></figcaption></figure>

#### REQUIREMENTS

**Premium Tier** and **Deluxe Tier** subscriptions have full functionality access to this feature. You should have the "Guild Tags" boosting feature unlocked to use this feature.

## Setup the Guild Tag Rewards system&#x20;

{% hint style="info" icon="sparkle" %}
New feature: Let us know your thoughts and share any bugs with us through our discord server!
{% endhint %}

Once you have enabled the module, run the `/guildtagrewards config` command to get started. You will firstly be prompted to enter a reward role - this is the role which will be given to those who use your Guild Tag.

You can then configure the rest of the module, including the "log channel". These messages serve as encouragement for other users to add your tag as well, so make them generous and make it clear how to get the rewards. As such, this "log channel" should be a public read-only channel in your Discord server.

If you have multiple discord servers and want to allow them to use any of your guild tags, skip here. Otherwise, continue reading to learn how to customise the outputs.&#x20;

<figure><img src="https://3586591898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV42S9VMaNEibIOnrBXoN%2Fuploads%2FvoDeFJZWya0mYkNSpiqE%2Fimage.png?alt=media&#x26;token=b0ed03ff-a75b-4505-8bb9-839631be55f4" alt="" width="452"><figcaption></figcaption></figure>

### Customisation

The bot allows you to customise the log messages sent to people when they add and remove your guild tag. Use the "Guild Tag Added Embed" and "Guild Tag Removed Embed" button to configure each log message respectively. You can also use several parameters within these embeds, listed below.

{% code lineNumbers="true" %}

```
{member.mention}  - Mention the user who changed their status
{member.username} - The username of the member who changed their status
{member.id}       - The user id who changed their status
{guild.name}      - The server name where the event was triggered
{guild.id}        - The server id where the event was triggered
{guildTag}        - The guild tag which you are using
```

{% endcode %}

<figure><img src="https://3586591898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV42S9VMaNEibIOnrBXoN%2Fuploads%2FYI6tX80fw3aqQME4fO2V%2Fimage.png?alt=media&#x26;token=d4980835-0e76-4104-a180-8dedc03ef7b0" alt=""><figcaption></figcaption></figure>

### Multi-guild configurations

The bot also allows you to give rewards to those who are using a guild tag of a different server. This allows multi-server networks to give rewards for representing any of their servers.

To configure this, use the `/guildtagrewards config` command and use the **Guild Tag Selection** section. Press "Add Guild", then enter the Discord Server ID of the server whose guild tag should be allowed. These guild ids will be treated the same as if the user was using this server's own guild tag.

There is currently a limit of 10 linked servers. If you need higher limits, please contact our support team. If you need any assistance with multi-guild configurations, we are happy to help!

<figure><img src="https://3586591898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV42S9VMaNEibIOnrBXoN%2Fuploads%2FZ4DUQZA16AfT78KedKIJ%2Fimage.png?alt=media&#x26;token=3ece3c74-45a5-4341-a116-f46c25a1a405" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3586591898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV42S9VMaNEibIOnrBXoN%2Fuploads%2FbpRfj0KA9HgXOkP1YBE3%2Fimage.png?alt=media&#x26;token=3870f2ba-ae03-44ea-b5fe-98006c1e1a45" alt=""><figcaption><p><a href="https://zap-hosting.com/deluxe"><strong>Click here to be redirected to our affiliate link!</strong></a></p></figcaption></figure>
