# Help with Permission Problems

## Troubleshooting Bot Permissions in Discord Servers

If you’ve invited <mark style="color:red;">InHouseQueue</mark> to your Discord server, but you get "Bot is missing permissions" errors, this guide should hopefully help resolve the issue.

***

## Important

The <mark style="color:red;">InHouseQueue</mark> Support team <mark style="color:green;">**cannot**</mark> provide permission troubleshooting beyond what's covered in this article. We can't access every server to diagnose permission problems. If you're a server owner, admin, or moderator, it's your responsibility to understand how [Discord Permissions](https://support.discord.com/hc/en-us/articles/206141927-How-is-the-permission-hierarchy-structured) work.

Problems **specific** to InHouseQueue Discord Bot we can always help with!

[Support Server](https://discord.com/invite/NDKMeT6GE7)

#### **1. Check InHouseQueue's Role**

* **Verify Bot Role Placement:**\
  Go to **Server Settings → Roles**, and ensure <mark style="color:red;">InHouseQueue</mark>'s role is <mark style="color:green;">**above**</mark> the roles it needs to manage. For example:
  * <mark style="color:red;">InHouseQueue</mark> needs to manage channels and permissions, so its role (`In House Queue`) should be high enough to perform those actions.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-a4b2ca44f29d69219a5906cf76ebf25843d3d329%2Froles_permission.png?alt=media" alt="" width="401"><figcaption></figcaption></figure></div>

* **Role Permissions:**\
  Edit <mark style="color:red;">InHouseQueue</mark>'s role and confirm it has all necessary permissions. It needs:
  * Manage Server
  * Manage Roles
  * Manage Channels
  * View Channels
  * Send Messages
  * Manage Messages
  * Embed Links
  * Read Message History
  * Use External Emoji
  * Use Application Commands
  * Move Members

***

#### **2. Check Channel-Specific Permissions**

* Right-click on a channel where <mark style="color:red;">InHouseQueue</mark> isn’t working → **Edit Channel** → **Permissions**:
  * Ensure <mark style="color:red;">InHouseQueue</mark> has the following permissions:
    * Manage Channel
    * Send Messages
  * For Categories:
    * Manage Channel
    * Send Messages

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-76dd0fd2fd649dfaf05bda607561733d8fc84d57%2Froles_permission2.png?alt=media" alt="" width="401"><figcaption></figcaption></figure></div>

* If you’re using category-level permissions, ensure these are correctly inherited by the channels within the category.

<mark style="color:red;">InHouseQueue</mark> should <mark style="color:green;">**automatically**</mark> have all of these permissions after you've done the [Basic Setup](https://docs.inhousequeue.xyz/docs/quick-start). If you still get permission errors, it means your Discord Role permissions are complex and something is overriding the base permissions. If you have a "Bots" or "Members" Discord role in your server, try giving this role to <mark style="color:red;">InHouseQueue</mark>.

***

#### **3. Re-Invite InHouseQueue with Correct Permissions**

* If <mark style="color:red;">InHouseQueue</mark> was invited without all necessary permissions, you can try re-inviting it using the invite link [here](https://discord.com/oauth2/authorize?client_id=1001168331996409856).

***

#### **4. Ensure InHouseQueue Is Active**

* Check if <mark style="color:red;">InHouseQueue</mark> is <mark style="color:green;">**online**</mark>. If it’s offline:
  * Visit the [Support Server](https://discord.com/invite/NDKMeT6GE7) for latest updates.
* Ensure <mark style="color:red;">InHouseQueue</mark> is not **muted** from the server.

***

#### **5. Enable Slash Commands**

* Ensure <mark style="color:red;">InHouseQueue</mark> has slash commands enabled, go to **Server Settings → Integrations → Bots and Apps**:
  * Make sure <mark style="color:red;">InHouseQueue</mark> is listed and has slash commands enabled.
  * Check <mark style="color:green;">**Command Permissions**</mark> to ensure server members have access to <mark style="color:red;">InHouseQueue</mark>’s commands.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-e78bce8e4ac46e28f81601a31a51cd537cf21020%2Froles_permission3.png?alt=media" alt="" width="401"><figcaption></figcaption></figure></div>

***

#### **6. Most Common Issues**

* **Role Placement:** <mark style="color:red;">InHouseQueue</mark>’s role should always be high enough to manage roles and channels it interacts with.
* **Basic Roles:** Ensure <mark style="color:red;">InHouseQueue</mark> has "Members" or "Bots" Discord role if your server has one. This is likely the case in big servers with complex permissions.

***

#### Last Resort

As a last resort, you can give <mark style="color:red;">InHouseQueue</mark> <mark style="color:green;">**Administrator**</mark> permissions. This is usually not advised, but this will resolve any permission issues. Once you've confirmed providing <mark style="color:green;">**Administrator**</mark> works, you can begin to narrow down the permissions, or leave it.

{% hint style="warning" %}
We don't recommend giving **ANY** Discord Bots **Administrator** permissions. But this usually solves the issue.
{% endhint %}
