This article covers how to install either the Jira Cloud or Jira Data Center Pack - plus how to get started with Jira in Coda. If you are not familiar with the Jira Pack, Jira Data Center Pack, or Packs generally please consult the linked articles.
The Jira Pack and the Jira Data Center Packs are two separate ways of accessing Jira from Coda. The Jira Pack is available on Team and Enterprise plans and is used for connecting to cloud-based instances of Jira. The Jira Data Center Pack is only available on our Enterprise plan, and is used for connecting to on-premise instances of Jira. To learn about the difference between Atlassian Cloud and Atlassian Data Center, check out this resource.
Within this article you’ll find...
Install and connect the Jira Pack
If this is your first time installing a Pack, we recommend you check out these intro articles on installing a Pack and connecting to the Pack account.
There are slightly different installation steps for the standard Jira Pack and the Jira Data Center Pack, so we’ve broken the steps up into two sections.
Jira Pack (for Jira Cloud) installation
First, you need to install the Jira Pack in your doc:
On any blank line in your doc’s canvas, type a forward slash, followed by Jira (e.g. /Jira )
From the drop-down menu, select Jira (under the More Packs header)
You’ll then see a preview with all kinds of helpful info on the Pack. Click Add to doc in the upper right.
Next, when you’re ready to start using any of the Jira building blocks (i.e. create an Issues table, use a Jira formula, etc.) - you’ll be prompted to connect the Pack to your Jira account. Follow these steps to do so:
You can either select an existing Jira account (if there is any) or add a new account.
You will need to set the read permission level to determine who can view the data pulled from Jira. Our suggestion is to go with “You and anyone this doc is shared with.” You can always edit the read permission level later; See Jira Pack Settings on how to do so.
You will need to set the write permission level to determine who can perform actions in Jira within Coda. This allows whoever you grant permission to the ability to modify your Jira instance (such as create a new Jira issue). Our suggestion is to go with “Only you.” You can always edit the write permission level later; See Jira Pack Settings on how to do so.
That’s it - the Pack is now installed and ready to be put to use!
💡Tip: As an alternative to the slash command, you can browse and search Packs by clicking on Insert (upper right corner of your doc), and then type in “Jira” in the search box. You can also streamline the search by selecting Packs first and then type in “Jira” in the search box.
Jira Data Center Pack (for Jira on-premise) installation
If you want to connect to your on-premise instance of Jira, you’ll want to install the Jira Data Center Pack. To do so, follow the steps below:
Ensure your org admin (typically your IT admin) has enabled the Jira Data Center Pack for your team to install (full instructions on managing Packs for your Enterprise workspace here). Your org admin can approve Packs to be used by going to coda.io/docs → click on 3 dots in the bottom-left next to “More options” → Organization settings → Packs Approvals → Packs in your organization
Make sure the Jira Data Center Pack is enabled, and ensure your organization’s on-prem Jira Data Center instance meets these 3 requirements:
Be served via HTTPS and have an SSL certificate signed by a public certificate authority.
Have a publicly accessible hostname that resolves to an Internet-accessible IP address.
If a firewall or VPN is used to secure access to Jira Data Center at a network level, the IT administrator must add an IP allowlist so that Coda can access this system.
On any blank line in your doc’s canvas, type a forward slash, followed by Jira (e.g. /Jira data ). Click on the first option.
You’ll then see a preview with all kinds of helpful info on the Pack. Click Add to doc in the upper right.
Now the Pack is added to your doc. Once you start putting the Pack to use (i.e. creating an Issues table, adding a Create issues button, etc.), you’ll be prompted to connect the Pack to your Jira Data Center account:
Enter your Jira Data Center URL and API Token.
The API token refers to a unique identifier you can obtain from Jira to permit Coda to connect to your Jira instance. In Jira, this is referred to as a Personal Access Token. See the FAQ below for info on how to find this token.
You will need to set the read permission level to determine who can view the data pulled from Jira. Our suggestion is to go with “You and anyone this doc is shared with.” You can always edit the read permission level later; See Jira Pack Settings on how to do so.
You will need to set the write permission level to determine who can perform actions in Jira Data Center within Coda. This allows whoever you grant permission to the ability to modify your Jira Data Center instance (such as create a new issue). Our suggestion is to go with “Only you.” You can always edit the write permission level later; See Jira Data Center Pack Settings on how to do so.
🎉 That’s it - the Pack is now installed and ready to be put to use!
Jira Pack Settings
In the settings of each Pack, you can set the default refresh rate for Pack data. You can also add, remove, and manage Pack accounts via the settings. To locate these settings...
Click on Insert in the upper right corner of your doc
Select Packs and then type in “Jira” in the search box
Under Installed Packs, select Jira
Scroll through the Settings tab to see all the ways you can customized your Jira permission levels and sync frequencies.
Put the Jira Pack to use
Once you’ve installed and connected the Jira or Jira Data Center Pack, you’re ready to start using any of its many building blocks. To see what these Packs have to offer, head to the Pack page by following these steps:
Click on Insert in the upper right corner of your doc
Select Packs and then type in “Jira” in the search box
Under Installed Packs, select Jira or Jira Data Center
Scroll through the Building blocks tab to see all the ways you can start using the Pack
You’ll see templates, tables, buttons, formulas, and more. You can click and drag any of these building blocks into your doc.
Want to learn about creating and updating Jira issues from Coda? Check out this article.
FAQs
Does Coda support connecting to on-premise instances of Jira?
Does Coda support connecting to on-premise instances of Jira?
Yes! You can connect to your on-premise Jira instance by using our Jira Data Center Pack. Check out the section above for info on connecting to this Pack.
What’s the difference between the Jira Pack and the Jira Data Center Pack?
What’s the difference between the Jira Pack and the Jira Data Center Pack?
The Jira Pack and the Jira Data Center Packs are two separate ways of accessing Jira from Coda. The Jira Pack is available on Team and Enterprise plans and is used for connecting to cloud-based instances of Jira. The Jira Data Center Pack is only available on our Enterprise plan, and is used for connecting to on-premise instances of Jira. To learn about the difference between Atlassian Cloud and Atlassian Data Center, check out this resource.
How can I find my API token or Personal Access Token in Jira?
How can I find my API token or Personal Access Token in Jira?
Coda will ask for your API token in order to connect to the Jira Pack. In Jira, this is called the Personal Access Token. You can find this in Jira following these steps:
Click on your profile picture at the top of your screen, then select Profile
Select Personal Access Token in the left-hand menu
Select Create token
Give your new token a name
You should now be able to copy and paste this token into Coda to connect to the Jira Pack.
Instead of syncing into Coda, can I just import my Jira data directly into Coda?
Instead of syncing into Coda, can I just import my Jira data directly into Coda?
If you want to migrate some data off Jira and start using Coda instead, you’ll first need to export your data from Jira. Then, you can use Coda’s CSV importer to bring your info in a Coda doc.
How can I learn more about using the Jira Pack in Coda?
How can I learn more about using the Jira Pack in Coda?
Now that you’ve installed and connected your Jira Pack in Coda, you’re likely ready to learn more about actually putting this Pack to use.
Check out this article to learn about using the Issues table and how to sync, create, and update Jira issues in Coda.
Read through this guide for a more comprehensive walkthrough of setting up and using the Jira Pack.
Search “jira” in our Gallery to see some examples of docs putting the Pack to use.