# Server Roles: Mobile Guide

## Creating a New Role

To start, you **must** own or have permissions in a Discord server to create a new role.

> To create your own Discord server, click the '+' icon in the server list, and select 'Create My Own'.

Next, you'll need to head on over to your server's settings to edit the roles. To do this, go into the server you wish to edit, where you can see the list of channels. Tap the server name, and click "Settings". Afterwards, scroll down to "Server Management", and select "Roles".

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2FcJYrw1s1hFmtN6u9c4JM%2FIMG_E0959.JPG?alt=media&#x26;token=8e3d45a2-3975-479d-8553-5d7019b8bde2" alt="" width="375"><figcaption><p>Example - How to Find Server Settings</p></figcaption></figure>

Once you've selected to edit your server's roles, you'll be met with this page:

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2F67eQaNbZBdpX96gXi8nU%2FIMG_E0960.JPG?alt=media&#x26;token=fd41ac02-fe88-486c-95bc-2b8c4b09e0c8" alt="" width="375"><figcaption><p>Server Settings > Roles Example Page</p></figcaption></figure>

To create a new role, click the + icon in the top right corner.

### Step 1: Role's Name & Colour

Here, you can edit the role's name and colour.

* The **Role's Name** may appear in the user list, as shown below. However, this only works if the option 'Display role members separately from online members' is toggled on, and if the role is the user's highest (see [#managing-positions](#managing-positions "mention")).

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2FqL1A9SQBql0ELufvVr5o%2FIMG_E0964.JPG?alt=media&#x26;token=02d099a8-c3a3-49d0-bce0-cf8e2c9d1bbb" alt="" width="375"><figcaption><p>Member List - how roles are seen.</p></figcaption></figure>

* The **Role Colour** will be used to give users colour. Likewise with the role's name, if this role is the highest on the user, that colour will be used.\
  \
  In the example below, I have selected a blue, and for most users, the role will appear as shown:\
  (Some users will view the role colour differently, depending on their settings.)

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2FNEuEMQQgj3Usb89GgZxc%2Fimage.png?alt=media&#x26;token=a5af70a6-8252-4fec-9645-59def2397514" alt=""><figcaption><p>Display of User who has a Coloured Role</p></figcaption></figure>

### Step 2: Setting the Role's Permissions

Automatically, each role you create will have no permissions. Once you add permissions, any user who has this role will be able to perform any action you grant them, such as "Create Invite".

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2FodMSIhyM0ZOOSX3d3syS%2FIMG_E0962.JPG?alt=media&#x26;token=259a8564-8882-4368-bdb3-60dbd318f1f0" alt="" width="375"><figcaption></figcaption></figure>

No matter the position of the role (highest, or the lowest), this role will still grant the permissions you have selected. However, **channel overwrites** will affect your role's permissions (unless you've chosen the 'administrator' permission).

**Channel Overwrites** are unique permissions you can set per category or channel. See [categories-and-channels](https://docs.botwiz.dev/botwiz-guides/discord-guides/categories-and-channels "mention")

#### Editing & Accessing More Permissions

When creating a new role, you'll be given four set choices of permissions. However, there are more specific options you can toggle.

Head back to the Server Roles page, and select a role. Next, select "Permissions". Here you will have a list of unique permissions you can select.

{% hint style="warning" %}
The **administrator** permission will allow users' with the role to have every permission, including: accessing every channel, banning users, editing all server settings and more.

This is a **dangerous** permission to grant.
{% endhint %}

### Step 3: Manage Members

This tab shows all of your server's members, with a checkbox you can select to add your newly-created role to that user's profile.&#x20;

You can edit the roles that a user has later-on.

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2F1fbS5tFIu7dXULGLNGGK%2FIMG_E0963.JPG?alt=media&#x26;token=d682059d-1dae-4329-ae83-a4814e6f904f" alt="" width="375"><figcaption><p>Step 3: Adding Members</p></figcaption></figure>

## Editing Existing Roles

Once you have created some roles, you will be able to modify them. On mobile, you will have greater access to a role's settings by modifying them; settings that were not available to you when creating the role.

Head over to your Server Settings > Roles tab, and select a role you'd like to edit. You will then see the following page:

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2FrrzP6ojFHBJB4CSEp9ZJ%2FIMG_E0966.JPG?alt=media&#x26;token=77dbe2e4-37b4-4517-979a-b3edc106ecca" alt="" width="375"><figcaption><p>Modifying a Role</p></figcaption></figure>

Here, you can access more options; specific permissions to toggle; and linked roles. \
Additionally, this page is how you can delete a role.

<details>

<summary>Linked Roles: what are they?</summary>

Links allow your roles to have connections to other playforms, such as Twitch, YouTube and Steam.&#x20;

With a linked role, you can add multiple connections with their own requirements - such as having a Twitter account that is at least 10 days old, and at least 10,000 followers.

<img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2FlfZpWOwttiwmxCXc0Ykb%2Fimage.png?alt=media&#x26;token=e57fe80d-9065-4398-b569-2c0574eae40c" alt="List of Connections" data-size="original">

![](https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2FbKcLY0Lfx1TfgGAxyJsT%2FIMG_E0967.JPG?alt=media\&token=9cb1f64d-23b9-473f-be8d-c2ec428bb214)

When creating a linked role, **these roles will be given to users automatically** once they meet your role's requirements. Therefore, I'd advise to have low permissions for these roles to keep the server safe.

</details>

### Managing Positions

#### Role Positions: what are they?

Discord roles each have their own position. The following usually determines how positions are set:

* Roles with higher positions will often hold more permissions and be roles for admins or moderators.&#x20;
* Roles with low permissions, or are roles purely for decoraction or utility (such as a "Ping for Announcements" role) should have lower positions.

Using BotWiz as an example, the following is an example of how positions affect how roles work:

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2Fh7goEYcNadGUPFsfHABA%2FIMG_E0968.JPG?alt=media&#x26;token=cf617d87-92e1-48c1-b3c6-a869b0e4b07a" alt="" width="375"><figcaption></figcaption></figure>

As shown, "Bacio's Team" is at the top of the user list, meaning it has a higher position than "Management Team", "BotWiz", "Moderation Team" and "Partner".

#### Role Position Permissions

When moderating a user on Discord, for example, the moderator must have a role higher than the user they're moderating. Otherwise, they are attempting to moderate a user that, in theory, has greater permissions than the moderator.

Say for example, I Catnip, try to moderate Ducky. This will not work as Ducky has a role above my highest role. I am unable to timeout, kick or ban Ducky as they have a greater role, and greater role permissions than me.

Therefore, it's important to keep your roles in order, such as the image below.

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2FwuSUwBr5PX1YkbiAGh39%2FIMG_E0969.JPG?alt=media&#x26;token=3e0bd5b0-84a8-45e8-9d08-c5ef4a6ca214" alt="" width="375"><figcaption><p>Role Hierarchy Example</p></figcaption></figure>

#### How to Edit a Role's Position

Head over to your Server Settings > Roles page, and click '<mark style="color:blue;">Reorder</mark>'. This will open a new page, as shown below. By using the 6-dotted icon on the left of each role, you can click and drag the role selected to a new position.&#x20;

You can also use this page to delete multiple roles quickly.

<figure><img src="https://3071155663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3kWzjw3glf7IkiBD8sfd%2Fuploads%2FdDrf8wSX1icZMb9X1RRK%2FIMG_E0970.JPG?alt=media&#x26;token=210e407a-0bf6-440b-a9cd-13b09d04df59" alt="" width="375"><figcaption><p>Editing a Role's Position</p></figcaption></figure>

{% hint style="warning" %}
On mobile, you can not edit a role's icon. This is only available on Discord's Desktop version.
{% endhint %}


---

# 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.botwiz.dev/botwiz-guides/discord-guides/server-roles/server-roles-mobile-guide.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.
