/   ...
/   Jira integration
/   Jira integration

Jira integration

Jira integration theydo

With the Jira integration, you can sync TheyDo solutions with Jira projects. 


How to install and authorize Jira in TheyDo

To install the Jira integration you need to be on the Management plan in TheyDo.

  1. Go to Settings in TheyDo (bottom left corner of your dashboard) and click on Integrations

  2. Click ‘Enable’ in the Jira product integration line

  3. Enter your Jira cloud details (find it by navigating to your Jira cloud environment and copying the part between https:// and .atlassian.net)

  4. Click ‘Authorize’.

  5. Install the TheyDo app in Jira:

    • In Jira, navigate to the Jira Apps marketplace and search for TheyDo

    • Install the TheyDo app in your Jira environment

    • Once the app is installed, go back to TheyDo and press Authenticate.

    • The authentication won’t work until the app is fully installed (try to remove and reinstall the app if it doesn’t work)


Setting up two-way synchronization

When you create a solution in TheyDo, you can push it to Jira as an Epic, a Story, a Task, or a Bug. Then, when the description changes in Jira (e.g. acceptance criteria are added), you will see those changes reflected in TheyDo.

  • Choose a default project to serve as the main Jira project to which Solutions are pushed or linked (you can choose the specific project every time, but this default project saves you a click).

  • Toggle on 2-way synchronization and click on ‘Update’.

  • If you don’t want the Title and Description to update after the initial push (or during linking), then keep this turned off.


Map statuses

  • Choose the Jira project that you want to connect with (multiple projects can be linked to one workspace)

  • Choose the TheyDo workspace that connects to that Jira project.

  • On the left you see the statuses of the Jira project. On the right, you can link a TheyDo status to those Jira statuses. When a work item changes status in Jira to the status on the left, TheyDo will update the solution status to the linked status


Security and rights management

The Jira integration complies with Atlassian’s security requirements.

Continue reading: