📖 Browse Documentation

Configure Bot Permissions

Use this guide when a Discord destination shows Needs access, or to control who can use the app's Jira features.

Choose the right bot

Your feature Bot to give access
Notifications and issue discussions Jiri
Ticket Automation Jiri Support

Roles can be renamed. Check the bot's assigned role in Server Settings → Members if you are unsure.

Fix access to a channel or forum

You need permission to edit the Discord channel. If a control is disabled, ask a server administrator.

  1. In the server selected in Jira, right-click the destination channel or forum → Edit Channel → Permissions.
  2. Open Advanced permissions. Select the correct bot or its role under Roles/Members; add it to the list if missing. Do not change @everyone to give one bot access.
  3. Set the permissions listed in Jira to Allow (the green check), then Save Changes in Discord.
  4. Return to Jira and select Recheck permissions. This reads Discord access; it does not grant permissions.
  5. When the warning clears, save your Jira settings and test a ticket or notification.
Discord permission controls: Deny on the left, inherit in the middle, and Allow on the right
Choose the green check on the right to allow a permission. The middle option inherits existing settings.

Still blocked?

  • Check the same bot and destination. Changing Jiri's access does not change Jiri Support's access.
  • Check channel overrides. Server-role permissions can still be denied in a channel. A bot-specific deny overrides a role allow.
  • Check the category. Changes affect synced channels only. An unsynced channel needs its own changes. Use Sync Now only if you intend to replace its overrides.

Give access only to the destinations you need. Private channels can allow a bot through its roles or member overrides; Administrator is not required.

What the permission names mean

Follow the missing-permission list in Jira for your selected workflow; you do not need every permission below for every destination.

Permission Used for
View Channel Access the destination
Send Messages Send channel messages or create forum posts
Send Messages in Threads Reply inside threads and forum posts
Create Public / Private Threads Create the selected kind of ticket thread in a text channel, not a forum
Embed Links / Attach Files Send formatted messages and files
Read Message History Read earlier messages
Manage Threads Manage ticket threads, including closing and locking

Choose who can use Jira features

In Project Settings → Apps → Discord → General Features → Permissions, select Edit beside a feature.

Feature Who you can allow
/create issue Disabled, connected users, or all Discord server users
/search issues Disabled, connected users, or all Discord server users
Personal notifications Disabled or connected users

Connected users have linked their Jira account.

Jira project permissions with Edit actions beside issue creation, search and personal notifications
Use Edit beside the feature you want to change.

For Jira access errors, see Fix project permissions. Still stuck? Contact support.