📖 Browse Documentation

Connect Discord Server

📋 Before You Jump In: Make sure you've completed the previous guide: Install the App

Time to connect your Discord server to Jira and enable your first project. This is a two-step process:

  1. Connect Discord server instance-wide to your Jira site
  2. Enable specific Jira projects to use the connected Discord server

We'll have you chatting with your team in no time!

Step 1: Connect Your Discord Server

First, let's connect your Discord server to your entire Jira instance.

  1. Navigate to General Settings:
    • Click the Settings gear icon in your Jira header
    • Select Apps from the menu
    • Under Discord for Jira, click General Settings
Access General Settings through Jira admin settings
Access General Settings through Jira admin settings
  1. Add Jiri Bot to Your Discord Server:
    • Click Add to Discord to start the connection process
General Settings page with Add to Discord option
General Settings page with Add to Discord option
  1. Authorize Jiri in Discord:
    • You'll be redirected to Discord to authorize the bot
    • Select your Discord server from the dropdown
    • Click Authorize to grant the necessary permissions

💡 Quick tip: Jiri needs permissions like sending messages and managing threads to work properly - all standard stuff!

Discord authorization flow
Discord authorization flow
  1. Confirm Connection:
    • Return to Jira - your Discord server should now appear in the connected servers list
    • Success! Your server is now available across all Jira projects

Step 2: Enable Your First Project

Now let's enable a specific Jira project to use your connected Discord server.

  1. Choose Projects to Enable:
    • In General Settings, scroll down to Jira Projects
    • Find the project you want to connect and click Enable
    • Select which Discord servers to enable for this project
Enable projects to use connected Discord servers
Enable projects to use connected Discord servers

💡 Pro tip: You can also enable projects individually by going to each project's settings, but doing it from General Settings gives you a nice overview of everything.

ℹī¸ Jira admin required for global settings

Only Jira admins can access Global Settings. If you do not see the "Manage Discord servers" shortcut in a project, ask a Jira admin to open Global Settings.

Quick Troubleshooting

🤔 Don't see your Discord server during authorization? Double-check you're logged into the correct Discord account and have "Manage Server" permissions.

🤔 Can't find General Settings? Make sure you have Jira admin rights - only admins can manage Discord server connections.

Still stuck? Drop by our Discord for Jira Community - we love helping out!

Enabling Additional Projects

💡 Need to enable more projects? You can enable as many Jira projects as you want to use with Discord:

  • Go back to General Settings → Jira Projects
  • Click Enable for each project you want to connect
  • Each project can use any of your connected Discord servers

You can also enable projects individually from each project's settings under Project Settings → Apps → Discord.

What's Next?

Great work! Your Discord server is connected and your first project is enabled. Now you can:

Time for a celebratory coffee! ☕ī¸