By integrating with Jira, you can pull in Issues as Dock tasks and sync updates between the two systems.

Add task from Jira

Task gets added to Dock and synced with Jira

To configure this integration, follow the steps below.

Step 1: Navigate to your admin panel by clicking Settings on the left hand nav bar.

Step 2: Under Integrations, select Jira:

Step 3: Accept data permissions.

Step 4: Add Atlassian workspace url:

Step 5: Add API token (follow instructions).

Step 6: Add your email address to log in to Jira.

The following data gets synced between the two systems:

Anything that you don't see in the above table will not get synced.

On the Dock side, this means things like start date, custom statuses, and/or internal statuses will not get pushed back to Jira. On the Jira side, any custom fields or additional fields not shown above will not sync to Dock.

Additionally, please note: commenting only supports plain text.

If you don't want to sync comments between the two platforms, simply turn off comment syncing from the integration page.

Comments made in an issue in Jira will flow over to the associated Dock task and will display the name of the person who made that comment. Please note though, Dock only supports plain text comments. You cannot attach files.

Comments that are posted in Dock by an internal team member (someone with both a Dock account and a Jira account) will post to the associated Jira issue, but they will come from the system integrator. To help clarify who the team member was that actually posted the comment, you'll see a note in brackets:

In this Jira comment above:

Alex has also turned on "email profile visibility" to allow third-party apps (Dock) to view his email address. See below for instructions on how to turn this.

When the user leaving the comment does not have a Jira account (i.e. your client), then here's what the message will look like:

This message came from a user "[email protected]" as denoted by the appended message to this comment.

In this example, Prateek Banga is the system integrator and that's why his name appears as the person leaving the comment and also why it says "posted on behalf of (Prateek Banga)."

Unfortunately, the quirks of this system are determined by Jira and our technical integration provider. There's nothing we can do about the "post on behalf of" situation. While not aesthetically pleasing, we're optimistic this integration still helps surface valuable information in each place.

Note: If you don't take the "email profile visibility" step below, then internal users will be treated like client users.

For users who are going to be leaving comments in Dock and Jira frequently, we recommend that they turn on email profile visibility into Jira. This will allow the two systems to recognize a shared internal user and not treat the user as a "client user."

To turn this on, each user will need to take the following steps:

Step 1: Login to Jira

Step 2: Go this page: https://id.atlassian.com/manage-profile/profile-and-visibility

Step 3: Scroll to the bottom

Step 4: In the contact section, turn the setting to "Anyone"

This setting will allow 3rd party apps to view your email address