Skip to main content

Required Bot Permissions

The bot requires a few permissions to work completely and without issues. Typically, all necessary permissions are automatically granted to the EasyPoll role when the bot is invited. However, in some cases, the inviter may revoke certain essential permissions, resulting in the bot stop working properly.

Required permissions

PermissionsRequiredFor what?
Send MessagesTo send poll and help messages
Send Messages in ThreadsTo send poll and help messages in Threads
Read Messages/View ChannelsTo read and receive poll messages
Read Message HistoryTo receive old polls and to be able to close them
Manage MessagesTo move poll messages and remove votes
Pin MessagesTo pin the poll message while a poll is running
Embed LinksTo send and update poll message embeds
Add ReactionsTo add the answer reactions for reaction-based polls
Use External EmojisTo use custom emojis, even from other servers
Mention @everyone, @here, and All RolesTo mention roles and users in poll messages
Create Public ThreadsTo create threads for polls
Manage ThreadsTo manage/close threads for polls
Attach FilesTo send poll result exports and event logging directly as a file
Manage WebhooksTo setup webhooks for a event logging channel
View Audit LogTo remove active votes when a user is kicked or banned
AdministratorNot required, but recommended if you're unfamiliar with or don't want to deal with channel permissions. Required to automatically set the bot's permissions correctly on the server and channel level in debug mode.

How do I check if the bot has all permissions?

We have added a /debug command that allows you to check all the required permissions of the bot on server and channel level.

debug

How do I set permissions at the channel level?

It is important that the required bot permissions are not overridden at the channel level.
If the bot does not have channel level permissions (because you are overriding it with the @everyone role, for example), you can set the permissions at channel level as follows:

  1. Go to the Channel Settings
    edit-channel

  2. Go to Permissions
    channel-permissions

  3. Add EasyPoll
    permissions-add-role

  4. Select all required permissions and click save changes
    set-channel-permissions

What happens if the bot does not have all required permissions?

EasyPoll will try to work as well as possible, but you may run into problems, for example:

  • EasyPoll cannot post the poll message at all, or
  • The poll message does not update or show as closed when the poll ends, or
  • Threads, pinning, or the winner announcement don't work, or
  • Result exports and log messages can't be sent