> For the complete documentation index, see [llms.txt](https://docs.pixx.ie/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixx.ie/getting-started/setting-up-the-bot/granting-permissions.md). # 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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.pixx.ie/getting-started/setting-up-the-bot/granting-permissions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.