""urlaub""

Author: SCDerox

docs/assets/linked-roles/role-managment/add-new-role.png

@@ -141,6 +141,9 @@ Your new Linked Role Bot won't stay online unless you use another SCNX product w
 :::
 
 Finally, finish setup by inviting the Linked Roles Bot to your server. Do so by clicking "Invite Linked-Roles-Bot" in
-the dashboard. Once done, you can continue by creating your first Linked Role. To learn more about that, continue in our [Role management documentation](./linked-roles/role-managment#create-linked-scnx-role), where we explain how to create your Linked Roles on SCNX and on Discord. 
+the dashboard. Once done, you can continue by creating your first Linked Role. To learn more about that, continue in
+our [Role management documentation](./linked-roles/role-managment#create-linked-scnx-role), where we explain how to
+create your Linked Roles on SCNX and on Discord. You can also jump
+to [the Linked Roles index page](/docs/linked-roles/index) if you are looking for something else to continue with.
 
 ![This screenshot shows the success message after setup](@site/docs/assets/linked-roles/setup/success-party-time.png)

docs/assets/linked-roles/role-managment/display-role-in-chat.png

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 3
 description: Follow this guide to claim a Linked Role that has been assigned to you.
 ---
 

docs/assets/linked-roles/role-managment/role-discord-settings.png

@@ -62,8 +62,8 @@ The following features are available on SCNX:
 
 * Easy management of [Linked Roles](./role-managment) in the SCNX Dashboard.
 * [Assign and remove](./user-managment) roles from users.
-* Authorization with your custom Discord App.
 * Multiple themes available for the [authorization page](./settings#authorization-page).
 * Off-Brand options available with the [Professional Plan](./../scnx/guilds/plans).
+* Authorization with your custom Discord App.
 * You can set up [public linked roles](./role-managment#public-roles) that can be claimed by any user.
 * Excellent customer support on [our Discord](https://scootk.it/dc-en) in English and German.

docs/linked-roles.md

@@ -1,9 +1,56 @@
+---
+sidebar_position: 2
+description: Learn how to create, delete and configure Linked Roles.
+---
+
 # Manage Linked Roles
 
+In contrast to traditional roles on Discord, Linked Roles require more steps to be correctly set up and configured.
+
 ## Create Linked Role on SCNX {#create-linked-scnx-role}
 
+:::info Discord Limit
+Discord enforces a strict limit of five Linked Roles for each bot. This means that you can't have more than five Linked
+Roles on SCNX.
+:::
+
+Open your the [roles page of your Linked roles dashboard](https://scnx.app/glink?page=linked-roles/roles) and click on
+"Add new Linked Role". If this is your first Linked Role, the site will automatically take you to the role creation
+flow, no need to click anything.
+
+There, enter a name for your role and choose a description. Once done, click on "Create Linked Role". After clicking,
+SCNX will prompt you to [configure the new linked role on Discord](#linked-role-on-discord).
+
+![This screenshot shows the role creation modal](@site/docs/assets/linked-roles/role-managment/add-new-role.png)
+
 ## Set up Linked Role on Discord {#linked-role-on-discord}
 
+To set up a Linked Role on Discord, please follow these steps:
+
+1. Create a new role on your Discord server. You can configure its role, role icon, permissions, and color. Do not
+   assign this role to any user.
+2. In your role settings, go to the "Links" tab.
+3. There, click on "Add requirement".
+4. Select your bot in the "Apps" section.
+5. Select the desired Linked Role. The role you select needs to
+   be [assigned to users on SCNX](./user-managment#add-role) to claim the newly created Discord role.
+
+Once you've finished these steps your members can [can claim the role](./claim-roles.md), if they have
+been [assigned the Linked Role](./user-managment#add-role).
+To actually display the role next to the username of a user, you'll need
+to [setup permissions correctly](#display-in-chat).
+
+![This screenshots shows how to add the role requirement on Discord](@site/docs/assets/linked-roles/role-managment/role-discord-settings.png)
+
 ## Display Linked Role in chat {#display-in-chat}
 
-## Public roles {#public-roles}
+By default, Linked Roles won't show up next to usernames in the chat. To display the Linked Role, you'll need to create
+a channel overwrite on **every channel**. This can be done by going into the channel settings of any channel, going to
+permissions, selecting (or adding) your Linked Role and giving it the "View Channel" permission. This overwrite is
+required for every channel you want the role to be displayed in.
+
+![This how to set up permissions for a Linked Role](@site/docs/assets/linked-roles/role-managment/display-role-in-chat.png)
+
+## Public roles {#public-roles}
+
+## Delete Linked Roles {#delete-role}