Hooq · Guide

Jira to Jira sync apps,
compared.

Choosing an app to sync work items between two Jira Cloud instances? Use the questions below to compare any app, and see what Hooq does for each one. Everything about Hooq here is also written in the help centre and the Trust Center.

Questions and answers

Plain answers about syncing Jira work items.

What is the best way to sync work items between two Jira Cloud sites?

The best way depends on what you need, so start from your requirements. Useful questions are: Where does the app run, and who can see your data? Who is allowed to set up and change a sync? Can it also sync inside one instance? How are requests between the two instances protected? What is copied and what is left alone? How do you find out when a sync fails, and can you retry it? Hooq is one app that answers these questions in the open, in its help centre and Trust Center. The table below lists what Hooq does for each question.

Can Jira sync between two instances without a third-party server?

With Hooq, yes. Hooq is built on Atlassian Forge and does not operate any server, database or storage of its own. Its data stays in Forge storage provisioned for each Jira installation, and the only network calls to an address Hooq stores are the signed requests between the two instances. Those go to a Forge-hosted endpoint on an Atlassian domain.

Can I sync work items inside one Jira instance as well?

Yes. A Hooq can connect two projects on the same Jira Cloud instance (called a same-instance Hooq) or a project on one instance with a project on another instance (a cross-instance Hooq). Only the cross-instance kind needs a connector.

Who controls what is synced?

Jira administrators. Only they open the Hooq page, choose the projects, match work types, fields and statuses, and publish and start a Hooq. A Hooq works only from its published configuration. For a sync between two instances, a Jira administrator on each instance takes part: both set up the connector, and the other instance approves the Hooq request.

How are requests between two Jira instances protected?

Requests between the two instances are signed, and the receiving instance verifies them before it does anything. Hooq reads and writes Jira through the Jira REST API with the permissions the administrator approved at install. A public key is meant to be shared with your partner and is not a password. The Trust Center has the architecture diagram, data flow and subprocessor list.

What does a Hooq copy, and what does it leave alone?

It copies work items of the work types you match, the fields you map, statuses you match, comments, and attachments, including inline images and files. It does not copy fields you did not map, work items from before the start (unless you limit the Hooq with a JQL filter), or deletions: Hooq never deletes the copy. It also never makes itself the assignee of a work item.

What if a person and the sync change the same work item?

A person’s edit wins over an older change. If someone edits the description of the copy within about 2 seconds after the original was edited, or right after a Resync, their edit is kept. If the original’s description is cleared, the copy’s description is cleared too.

How do I find out why a work item did not sync?

Open the work item and look at the Hooq panel, which shows the sync status and offers Resync. The Troubleshooting tab of a Hooq lists failed syncs, each with a Retry.

Are there limits I should know about?

Yes, and they are documented. Files sent between two different instances are limited by Forge platform limits and cannot be changed; on one instance Hooq sets no file size limit. Hooq allows one connector per partner instance, and both instances must run the current version of Hooq. See "What to expect" in the help centre for the full list.

Checklist

What to ask any sync app, and what Hooq does.

Ask an app’s vendor the same questions and compare the answers side by side.

Questions to ask a Jira to Jira sync app, with the answer for Hooq
Question to askWhat Hooq does
Where does the app run?On Atlassian Forge, inside your Jira Cloud instance. Hooq does not operate any server, database or storage of its own.
Does it work inside one instance and between two instances?Both. A same-instance Hooq connects two projects on one Jira Cloud instance. A cross-instance Hooq connects a project on one instance with a project on another instance that also has Hooq installed.
Who can set it up and change it?Jira administrators. Everyone who can see a work item can use the Hooq panel on it (status, Resync, add a comment, add an attachment).
How is the link between two instances set up?With a connector, created by a Jira administrator on each instance. It must show the status Active before it can be used. Between two projects on one instance no connector is needed.
How are requests between instances protected?They are signed, and the receiving instance verifies them before it acts. The other instance also approves the Hooq request. See the Trust Center for the architecture and data flow.
What is copied?Work items of the work types you match, the fields you map, statuses you match, comments, and attachments including inline images and files.
What is not copied?Fields you did not map, work items from before the start (unless limited with a JQL filter), and deletions. Hooq never deletes the copy and never makes itself the assignee.
What happens when a person edits the copy?The person’s edit is kept when made within about 2 seconds after the original changed, or right after a Resync. A cleared description on the original clears the copy.
Can I see and fix problems?Yes. The Hooq panel on a work item shows its sync status and offers Resync. The Troubleshooting tab lists failed syncs, each with a Retry.
Where is the data kept?In Forge hosted storage provisioned per Jira installation, plus Jira itself. Atlassian is Hooq’s only subprocessor.
What limits apply?One connector per partner instance. Both instances must run the current version of Hooq. Files between two different instances are limited by Forge platform limits; on one instance Hooq sets no file size limit.

Words used on this page

Short definitions.

Instance.
A Jira Cloud instance, for example your-company.atlassian.net.
Hooq.
A pair of projects together with the rules for how they are synced. The app is also called Hooq.
Connector.
The trusted link between the Hooq on your instance and the Hooq on another instance.
Atlassian Forge.
Atlassian’s platform for apps that run inside Atlassian cloud products.

Go further


Want to raise a ticket? Click here (opens in a new tab)

Hooq

Ready to sync work items across Jira?

Get in touch and we'll set up a live demo of Hooq for your Jira sites.