# Granting permissions

## Required permissions

PixxieBot only asks for the minimum permissions she needs to work in your Discord server.

The permissions required to allow PixxieBot to function correctly in your server are as follows:

* [x] Manage Nicknames
* [x] Read Messages
* [x] Send Messages
* [x] Manage Messages
* [x] Embed Links
* [x] Attach Files
* [x] Read Message History
* [x] Add Reactions
* [x] Use External Emojis

{% hint style="danger" %}
These are the **only** permissions PixxieBot requires to work in your server. If your server has granted higher permissions to her role or another role you have assigned to the bot, please make sure you [reset the permissions](#resetting-and-updating-pixxiebots-permissions) or fix your role permissions.
{% endhint %}

## Restricting or disabling PixxieBot commands

You can customize who can use PixxieBot commands, which commands can be used, and in which channels. Start by logging into Discord in your browser or desktop app. Then navigate to PixxieBot's settings under the "Integrations" tab in your Discord server's settings. Here you can fully manage permissions for the bot and for users based on commands, channels, roles and usernames.

## Required text channel permissions

Within your text channel settings, make sure PixxieBot has the following permissions for the best bot experience:

* [x] Read Messages
* [x] Send Messages
* [x] Manage Messages
* [x] Embed Links
* [x] Attach Files
* [x] Read Message History
* [x] Use External Emojis
* [x] Add Reactions

## Resetting and updating PixxieBot's permissions

Sometimes we add new features that may require more permissions. If this happens, we will notify you in our [support server](https://pixx.ie/support).

{% hint style="info" %}
To reset PixxieBot's permissions [click here](https://pixx.ie/invite) and re-invite the bot to your server. This will overwrite the `@PixxieBot` role permissions in your server without the need to kick the bot.
{% 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.pixx.ie/getting-started/setting-up-the-bot/granting-permissions.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.
