This integration is available from the Essential plan and above.

Jira is a software development tool used by agile teams. In this guide you'll learn how to setup Jira Cloud and Jira Server integration, and how to manage your Jira integration on Lokalise.

Index

Enabling Jira Cloud integration

To get started with the Jira Cloud integration, perform the following steps:

  • Open your translation project on Lokalise and click the More button.

  • Choose Integrations from the dropdown.

  • Find Jira Cloud in the integrations list and click Connect.

  • Click Connect again and login with your Atlassian account.

  • Give Lokalise access to your workspace and you are good to go!

Enabling Jira Server integration

To get started with the Jira on-premises integration, perform the following steps:

  • Open your translation project on Lokalise and click the More button.

  • Choose Integrations from the dropdown.

  • Find Jira Server in the integrations list and click Connect.

  • Click Connect again. You'll see the following screen:

  • Click on the "following public key" link and download the public key to your PC.

  • Proceed to Jira, click on the Cog icon in the top right corner of the screen and choose Applications (you have to be an admin to perform this action):

  • Choose Application links from the left menu and enter https://lokalise.com in the URL text field. Once you are ready, click Create new link:

  • Enter the Application name (for example, "Lokalise") and click Continue:

  • After the application is created, click on the Pen icon next to its name:

  • Switch to the Incoming Authentication tab and enter the following info:
    Consumer key: provide a combination of random letters and numbers. This key should then be supplied to Lokalise.
    Consumer name: enter "lokalise"
    Public key: paste the public key obtained from Lokalise earlier (you can view the key by opening the downloaded file with any text editor)

  • Hit Save once you are ready and return to Lokalise.

  • Enter your Jira URL and the consumer key that you provided when setting up Incoming Authentication.

  • Click Authorize and allow access for Lokalise:

Working with Jira integration

Once the initial setup is completed, you'll see the following screen:

You can configure the following options:

  • Organization — your Jira organization that you would like to integrate Lokalise with.

  • Project — Jira project within the chosen organization.

  • Create a new Jira issue when — tick one or more events that should trigger creation of a new Jira issue (ticket). The created issues will be automatically linked to a trigger event.

  • Change Jira issue status when — tick one or more events that should trigger Jira issue update. Please note that this only works for the issues that were initially linked to a certain event.

  • Delete Jira issue when — tick one or more events that should trigger Jira issue deletion. Please note that this only works for the issues that were initially linked to a certain event.

  • Add comment to the Jira issue when translation task language is completed — this option applies to translation tasks only. As long as your tasks may contain multiple target languages, each language will probably be closed separately once all the corresponding items are translated. Therefore, when this option is checked the corresponding Jira issue will be updated with a brief comment mentioning which language was closed in the current task.

When enabling one of the options, you will be presented with the dropdowns to further customize the chosen options:

Please note that the elements provided in the dropdowns will highly depend on your Jira configuration.

To add another integration handler, click on the Add another handler button in the bottom of the page:

Here's an example of a Jira issue created for a new translation task on Lokalise:

Did this answer your question?