# Add Role User

`Add Role User` blocks are used to add Discord roles to Discord users. Discord roles are sets of permissions that define what users can and can't do in a Discord server. These roles are created and named by the owner or administrator(s) of the Discord server in question.

One common use of Discord roles is to hide the contents of a server (except for some kind of waiting room) from users who have not yet passed some kind of captcha. Once a user solves the captcha, they are granted a predefined role that gives them access to the rest of the server.

In addition to requiring a Discord connection as input, `Add Role User` blocks require a Discord guild (server) ID, a Discord user ID, and a string matching the name of the Discord role we are granting.

The following example is a kind of captcha bot that instructs the user to react to its message with a brain emoji; if they do, then we grant the user a Discord role called "member" using an `Add Role User` block. It is implied that a Discord role called "member" has been defined on the Discord server which grants general access to the server's contents.

<figure><img src="https://i.imgur.com/RjgkEaZ.png" alt=""><figcaption></figcaption></figure>

In the above example, we start by establishing a Discord connection using a [`Discord Connector`](/dev-tooling/blocks-messaging/discord/discord-connector.md) block to which we provide our bot's token. The `Discord Connector` block will fire automatically and immediately upon the start of the graph's execution, as all connector-type blocks do.

Next, our bot sends a message using a [`Send Discord Channel Message`](/dev-tooling/blocks-messaging/discord/send-discord-channel-message.md) block, instructing users in the channel to react to the message with a brain emoji.

We then use an [`On Reaction Added Message`](/dev-tooling/blocks-messaging/discord/on-reaction-added-message.md) block to listen for brain emoji reactions being added to our bot's instructional message.

Whenever we detect a brain emoji reaction to our bot's message, we use an `Add Role User` block to add a Discord role called "member" to the user who added the emoji reaction. Note that the "UserId" output on the `On Reaction Added Message` block is plugged into the "UserId" input parameter of the `Add Role User` block.

In general, note that Discord guild (server) IDs and Discord channel IDs can be found by right-clicking on a server or channel in the Discord app and clicking on "Copy ID". Similarly, it is possible to acquire the message ID of a message that has already been sent in a Discord channel by right-clicking on the message in Discord and clicking "Copy ID".

<br>


---

# 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://docs.graphlinq.io/dev-tooling/blocks-messaging/discord/add-role-user.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.