You can connect related work across Hive and Jira by linking action cards or project to existing Jira issues. This allows you to quickly track Jira issues within Hive. If further action is needed, you can open the Jira issue directly from Hive.
Linking an action card to an existing Jira Issue
1. Click on the Jira icon and select "Link to existing issue."
2. Type in the Jira ID or keywords from the Jira issue title for the issue you'd like to link.
Each Hive action can only have one Jira issue linked. However, each Jira issue can be linked to multiple Hive actions.
3. Once linked, you can monitor the Sprint, Status, and Priority fields on the Hive action card in the section highlighted below.
If the Jira assignee is in both Hive and Jira, they'll appear in the snapshot as well!
Details in your Hive action card will not be affected, so you can keep working in Hive while keeping track of changes in relevant Jira issues.
Want to mirror a Hive action card in Jira? Check out the article "Create a Jira issue from Hive."
Performing a sync between Hive & Jira Project
*Make sure both Workspace App Jira and Personal App Jira are turned on.
1. Click the More menu in the project.
2. Click Connect to Jira.
3. Choose which Jira Project to sync data to/from.
4. Choose the Data sync direction.
One way sync from Jira to Hive.
Any changes made in Jira will be reflected in Hive.
One way sync from Hive to Jira.
Any changes made in Hive will be reflected in Jira.
Two way sync between Hive and Jira.
Full list of items that will sync:
Hive | Jira |
Action Title | Issue Summary |
Action Description | Issue Description |
Action Scheduled Date | Issue Start Date |
Action Deadline | Issue Due Date |
Action Assignee | Issue Assignee |
Action Status | Issue Status |
Subaction | Issue Subtask |
Action Attachments | Issue Attachments |
Other fields such as Labels, Priority Levels, and Comments are not synced at the moment.
*Note - Jira's To Do status is the same as Hive's Unstarted status.
It's recommended to have the same statuses between the two apps.
Sync a project from Jira
After you connect a project and save a sync direction that brings changes from Jira into Hive, the project's Jira settings show Sync from Jira. Use it to bring the Jira project's issues into Hive now.
Select Sync from Jira.
In Sync project from Jira?, select Start sync. Hive creates actions for Jira issues that aren't linked yet. It also updates titles, descriptions, statuses, and the parent hierarchy from Jira, and adds Blocks dependencies. The existing Hive values for those fields are replaced.
If actions in another project are already linked
Some issues in the Jira project may already be linked to actions in a different Hive project in the same workspace. Then Hive stops and shows Unlink actions and continue sync? It says how many actions are linked and which Hive project they are in.
Unlink and continue sync: Hive removes the Jira links from those actions, and they stop syncing with Jira. The sync then continues and creates or updates actions in this project.
Cancel: nothing changes, and the sync doesn't run.
You may see one of these messages instead:
Jira links need repair: some actions have old Jira links that are missing Jira issue IDs, so Hive can't unlink them for you. Remove or fix the Jira link on each affected action, then sync again.
Unable to continue Jira sync: you don't have permission to change every action or project setting the sync needs. Ask a project owner to check the Jira links and project permissions, then try again.
Setting Up Custom Field Synchronization Between Hive and Jira
Finding your Jira Custom Field ID
Navigate to your Jira Custom field on the Jira Atlassian website:
Go to the "Custom fields" page
Select your field
Locate the ID in the URL (e.g., if URL ends with id=10055, use customfield_10055)
Alternatively, find the customfield_id via the Jira Atlassian REST API endpoint:
/rest/api/2/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId}
Configuring Hive Synchronization
Open your Hive Project
Click ... More → Custom Fields
Locate your custom field
Click ... Edit
Enter the customfield_id in the "Jira Custom Field ID" input
Field Value Requirements
For checkboxes, radio buttons, and select lists, text values must match exactly between Hive and Jira. For example, "Option1" ≠ "option1" because the first starts with an uppercase O and the second starts with a lowercase o. Change the text to match exactly in order to have them synchronize.
The custom field types previously listed, as well as Date Pickers, User Pickers, and Text fields, are supported.