""urlaub""

Author: SCDerox

docs/linked-roles/claim-roles.md

@@ -24,4 +24,4 @@ our [troubleshooting page](./troubleshooting), where we go into detail on how to
 
 ## Claim your role on Discord {#claim-role}
 
-To get started, please click on the name of the server in Discord. There you'll be able to select the option "Linked-Roles".
+To get started, please click on the name of the server in Discord. There you'll be able to select the option "Linked-Roles". 

docs/linked-roles/settings.md

@@ -1,3 +1,6 @@
+---
+sidebar_position: 5
+---
 # Linked Roles Configuration
 
 ## Authorization page {#authorization-page}

docs/linked-roles/troubleshooting.md

@@ -1 +1,81 @@
-# Troubleshooting
+---
+description: Using Linked Roles can be complicated and it's easy to run into issues.
+sidebar_position: 6
+---
+
+# Troubleshooting
+
+Using Linked Roles can be complicated, and it's easy to run into issues. In this document, we'll look at common issues
+and ways to fix these issues.
+
+## Overview {#content}
+
+Please select the issue you are running into.
+
+Issues during setup:
+
+* [I can't add the Link requirement to a Discord role](#link-requirement).
+
+Issues when using Linked Roles:
+
+* [The Linked Role is not displayed in the chat](#display-missing).
+* [Users are not being give the Linked Role](#role-not-given).
+* ["Invalid OAuth2 redirect_url" when claiming Linked Roles](#oauth2-redirect-url).
+* ["Seems like the configuration by the server owner is wrong." when claiming Linked Roles](#generic-api-error).
+
+If your issue isn't listed here, [click here](#other).
+
+## Issues during setup & configuration {#setup}
+
+### Can't save Link requirement on Discord role {#link-requirement}
+
+When [setting up a Linked Role on Discord](./role-managment#linked-role-on-discord), you might run into an "Invalid
+role" error when adding the Link requirement to a Discord role.
+
+**Solution**: You can't add Link requirements to roles that has members. Consider removing the role from all of your
+members or create a new role.
+
+## Issues when using Linked Roles {#usage}
+
+### The role is not displayed in the chat {#display-missing}
+
+When using Linked Roles, you might run into an issue where the role is not displayed next to the username in the chat.
+
+**Solution**: To display the Linked Role next to the username, you'll need to create a permission overwrite with the
+"View channel" permission for the Linked Role in every channel. You
+can [learn more in our guide about this](./role-managment#display-in-chat).
+
+## "Seems like the configuration by the server owner is wrong." when claiming Linked Roles {#generic-api-error}
+
+
+
+## "Invalid OAuth2 redirect_url" when claiming Linked Roles {#oauth2-redirect-url}
+
+When setting up Linked-Roles, the redirect URL needs to be saved in the Discord Developer Portal; otherwise this error
+will be shown.
+
+**Solution**:
+
+1. Open your [Linked Roles configuration pag](https://scnx.app/glink?page=linked-roles/configuration) and copy the "
+   Redirect URL" in the "Authorization details" card. It should look like this:
+   `https://linked-roles.scnx.app/api/b4e5e89a-1c92-11f0-b688-03c2706e348f/callback` (the middle part might change based
+   on
+   your server).
+2. Open the [Discord Developer Portal](https://discord.com/developers/applications) and select your bot.
+3. Go to the "Oauth2" tab of your bot, and click on "Add another" in the "Redirects" section.
+4. Paste the copied redirect URL and save the changes.
+5. Retry [claiming the role](./claim-roles).
+
+![This screenshot shows where to paste the copied redirect URL](@site/docs/assets/linked-roles/setup/enter-redirect-url.webp)
+
+## Users are not being given the Linked Role {#role-not-given}
+
+When using Linked Roles, users won't receive the role automatically.
+
+**Solution**: Users need to manually [claim the Linked Role](./claim-roles). You can send them a link to our guide: [
+`https://scootk.it/claim-linked-roles`](https://scootk.it/claim-linked-roles).
+
+## Other issues {#other}
+
+Oh no, that's weird - we're always happy to assist you with your issue on our [Discord](https://scootk.it/dc-en) or
+on [scnx.app/help](https://scnx.app/help).

docs/linked-roles/user-managment.md

@@ -1,3 +1,6 @@
+---
+sidebar_position: 4
+---
 # Manage member's Linked Roles
 
 :::success Give your admins access!