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

# Grant Discord Role

> Discord role grant loyalty rule. Automatically assign Discord roles based on loyalty achievements.

<head>
  <script type="application/ld+json">
    {JSON.stringify({
            "@context": "https://schema.org",
            "@type": "TechArticle",
            "headline": "Grant Discord Role",
            "description": "Discord role grant loyalty rule. Automatically assign Discord roles based on loyalty achievements.",
            "author": {"@type": "Organization", "name": "Snag Solutions", "url": "https://www.snagsolutions.io/"},
            "publisher": {"@type": "Organization", "name": "Snag Solutions", "url": "https://www.snagsolutions.io/", "logo": {"@type": "ImageObject", "url": "https://assets.snagsolutions.io/public/docs/snag-logo-dark-no-bg.svg"}},
            "mainEntityOfPage": "https://docs.snagsolutions.io/loyalty/rules/discord-grant-role"
          })}
  </script>
</head>

## Overview

This loyalty rule allows admins to automatically grant a specific [Discord](https://discord.com/developers/docs) role to users when they claim the reward. This rule is useful for automating role distribution based on loyalty achievements or user actions.

## Prerequisites

* Snag Discord bot must be added to the Discord server with **Manage Roles** permission.
  * [Invite Link](https://discord.com/oauth2/authorize?client_id=1079691446724075562\&permissions=8\&response_type=code\&redirect_uri=https://admin.snagsolutions.io/\&scope=bot+guilds.members.read)
* The Snag Bot role must be higher in the Discord role hierarchy than the role being granted.
* The user must have connected their Discord account to Snag.

<Warning>
  **Important:** The Snag Discord bot requires the **Manage Roles** permission
  to function correctly. Additionally, ensure the bot's role is positioned above
  the role you intend to grant in your Discord server settings.
</Warning>

## Rule Configuration Fields

### **Reward**

* **Type of Reward**: Choose between "Points" or "Multiplier".

* **Points**: Users will get the defined no of points.

* **Multiplier**: Users will get the multiplier of the defined amount.

### Basic Settings

* **Update Cadence**: This defines when the rule will run. It can also be claimed manually by users via the **"Claim" button**.
* **User Reward Frequency**: This defines how often users can receive the reward (e.g., one-time).

### **Custom Settings**

* **Skip the multiplier for this rule**: If enabled, any global multipliers will not apply to this rule's reward.
* **Discord Server Id**: The ID of the Discord server where the role will be granted.
* **Discord Role Id**: The ID of the role(s) that will be granted to the users upon completion. You can define multiple role IDs to grant multiple roles at once.
