Skip to content

Discord Permissions

Getting permissions correct for your setup can be a struggle depending on how you have your Discord server setup. If you want to run a simple test to see if you have permission issues, set the Notifiarr role to have Admin permission and see whether it solves your issue. If everything works, this means you simply need to adjust permissions for the the Notifiarr role and you don't need to give it full admin permissions

To update the integration's permissions, click on your server name at the top and pick Server Settings > Roles. Click on the Notifiarr role and then pick Permissions.

Required Permissions

  1. View Channels
    • The bot needs this role to generate a channel list so you can assign which notifications go to which channels on your server. If the channel is a private channel, you may also need to adjust channel specific permissions.
  2. Send Messages and Create Posts
    • This one is obvious, without it the bot role can not add messages to channels
  3. Embed Links
    • Many notifications have links (such as TMDb, TVDb, IMDb, Website links, etc.)
  4. Add Reactions
    • *arr and Plex notifications add reactions to notifications to signify things such as the indexer, manual or rss grab, imported, failed, unpacked, subtitles, etc.
  5. Mention @everyone, @here and All Roles
    • Needed if you have alerts setup with Snapshots or Media Request integrations so the proper user/role can be @mentioned
  6. Manage Messages
    • This is used for the Media Request integration so the bot can remove all the back and forth posts when adding new things to leave a clean channel history
  7. Read Message History
    • This is used for the Media Request integration so the bot can get the user interactions and is also used to place reactions on existing messages

Optional Permissions

  1. Use External Emojis
    • Only required if the reactions you use are from another server
  2. Manage Channels
    • Only required with the Channel stats integration
  3. Connect
    • Only required with the Channel stats integration

If you manage your channels with individual permissions plus bot permissions, you will need to adjust them accordingly so the bot can do its job

  • If permissions are misconfigured, then the Notifiarr site will auto-disable the integration after 25 Discord API errors

  • If you are using reactions and get API errors, the site will auto-remove the reaction

  • If you are using the bot and have cleanup history enabled and get API errors, the site will auto disable it.

You will know when the site does this with a big red notice on top of the setup page that explains the error that Discord reported and what action was taken. All you have to do is fix the issue and re-enable what the site disabled from that point.