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.
- In the server selected in Jira, right-click the destination channel or forum → Edit Channel → Permissions.
- 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.
- Set the permissions listed in Jira to Allow (the green check), then Save Changes in Discord.
- Return to Jira and select Recheck permissions. This reads Discord access; it does not grant permissions.
- When the warning clears, save your Jira settings and test a ticket or notification.
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.
For Jira access errors, see Fix project permissions. Still stuck? Contact support.