Jira Integration

Integration with Atlassian Jira allows you to keep track of source string and translation issues reported by users working on the project translation in Crowdin.

Note

You will need to install the Jira Software integration in your Crowdin account before you can set it up and use it.

With current integration, the following issue types reported in Crowdin are supported for the Jira dashboard:

• General issues
• Lack of context issues
• Translation issues
• Source string issues

Each synchronized issue type will have the parent task in Jira named after it. Each issue reported in Crowdin will create a sub-task in the corresponding parent task in Jira.

Caution

The integration disables email notifications for project issues in Crowdin that are synchronized with Jira.

Once all reported issues have been resolved and their respective sub-tasks closed in Jira, you can also close their parent Jira task representing one of the Crowdin issue types.

As translators report new issues in the Crowdin project, the Jira integration will create new parent Jira task with its corresponding sub-tasks for each issue in the Crowdin project.

Connecting Jira with Crowdin

To connect Jira with your project in Crowdin, follow these steps:

1. Open your project and go to the Integrations tab.

2. Click on Jira Software in the Integrations list.

3. Enter the Base URL of your Jira project and click Set Up Integration. You’ll then access the Providing Access to Your Jira Project dialog.

4. Configure an Application Link in Jira:

   Note

   Only project administrators can set up Application Links.
   1. Log in to Jira as a user with Jira Administrator permissions.
   2. Go to Jira settings > Products > Application links.
   3. Click Create link.
   4. Select Direct application link, enter your Crowdin URL, and click Next. Due to Jira functionality, it sometimes does not receive the response from the entered URL. If you see the message below, check the provided URL to be correct and click Continue.
   5. Fill in all the required fields in dialog windows and click Continue to finish configuring the link:
      • Application name: Crowdin Integration
      • Application type: Generic Application
      • Select Create incoming link and click Continue
      • Consumer Key: Crowdin
      • Consumer Name: Crowdin
      • Public Key: copy it from the Providing Access to Your Jira Project dialog in Crowdin Click Continue to finalize the Application Link setup.

5. Go back to Crowdin and click Next in the Providing Access to Your Jira Project dialog.

6. Allow read and write access to project data in Jira. Crowdin will use this access to help the integration run correctly.

7. Choose the Jira project key, select types, and configure settings of Crowdin issues that you’d like to be synchronized with your Jira project. Jira issue settings available are:

   • Type
   • Subtask Type

     Note

     If you don’t select a subtask type, the first available option will be applied automatically.
   • Priority
   • Assignee
   • Labels (Optional)
   • Status – used to select the Jira status value that will trigger the closure of a related string issue in the Crowdin project.

     Note

     The status values that you can select are taken only from the Done status category in Jira (including Done, Closed, etc.).

8. Click Save.

Synchronizing Issues

Once you set up the integration, you can synchronize already existing issues in Crowdin (if any). A short message would tell you how many issues aren’t synchronized yet. To synchronize them, click Sync Issues.

Managing Jira Integration Settings

To change the integration settings, click Settings and apply the necessary changes. Updated settings will apply only to the newly synchronized issues. All the issues synchronized before will remain without any changes.

Note

If you change the Jira project key, already synchronized issues will remain as sub-tasks in Jira but won’t be resolved in Crowdin automatically.

Deleting Integration

To delete the integration, click Delete Integration.

Note

All synchronized issues will remain as sub-tasks in Jira but won’t be resolved in Crowdin automatically.