> For the complete documentation index, see [llms.txt](https://amy-2.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://amy-2.gitbook.io/docs/information/required-permissions.md).

# Required permissions

* Manage Roles \[Used for assigning and removing roles] 
* Manage Channels \[Used to create game channels] 
* View the audit log \[Used for proper logging] 
* Read Messages \[Used to get responses when setting up Amy] 
* Send messages Send messages in branches 
* Manage Messages \[Used to automatically delete replies when setting up Amy] 
* Attach files
* Add reactions (For memes and giveaways)
* Use external emojisTo function correctly and provide you with the best experience, Amy requires the following permissions on your server. Below is a detailed breakdown of **why** each permission is needed:

  ####
* #### 🛡️ Role Management

  | Permission       | Purpose                                                                                               |
  | ---------------- | ----------------------------------------------------------------------------------------------------- |
  | **Manage Roles** | Used for assigning and removing roles from members (e.g., auto-roles, reaction roles, premium roles). |

  ####
* #### 📁 Channel Management

  | Permission          | Purpose                                                                                      |
  | ------------------- | -------------------------------------------------------------------------------------------- |
  | **Manage Channels** | Used to create temporary or game-specific channels (e.g., private rooms, minigame channels). |

  ####
* #### 📋 Server Logging

  | Permission         | Purpose                                                                                             |
  | ------------------ | --------------------------------------------------------------------------------------------------- |
  | **View Audit Log** | Used for proper logging of server events (e.g., role changes, channel updates, moderation actions). |

  ####
* #### 💬 Message Handling

  | Permission                    | Purpose                                                                                             |
  | ----------------------------- | --------------------------------------------------------------------------------------------------- |
  | **Read Messages**             | Used to receive responses when setting up Amy and to process commands.                              |
  | **Send Messages**             | Used to respond to commands, send notifications, and interact with users.                           |
  | **Send Messages in Branches** | Used to post messages within threads and branches.                                                  |
  | **Manage Messages**           | Used to automatically delete replies and prompts during the setup process (to keep channels clean). |

  ####
* #### 🎨 Content & Engagement

  | Permission              | Purpose                                                                                 |
  | ----------------------- | --------------------------------------------------------------------------------------- |
  | **Attach Files**        | Used to send images, embeds, and files (e.g., generated content, results, screenshots). |
  | **Add Reactions**       | Used for memes, giveaways, polls, and interactive features that rely on reactions.      |
  | **Use External Emojis** | Used to display emojis from other servers (e.g., custom emojis in memes and responses). |

  ####
* #### 📌 Important Notes

  * **Minimum Required Permissions:** You can customize permissions in your Discord server settings, but disabling any of the above may cause certain features of Amy to not work properly.
  * **Security:** Amy only uses these permissions for the purposes listed above. We do not abuse these permissions to modify your server in ways you did not request.
  * **Troubleshooting:** If you experience issues with Amy's functionality, please double-check that all required permissions are granted in the channel or server settings.

  **Thank you for keeping Amy properly configured!** 💙

  *If you need help adjusting permissions, open a ticket in our* [*Support Server*](https://discord.gg/pears)*.*