# Jira

## Overview

Integrating Luna with Jira allows you to import your Jira issues and keep them in sync in Luna bi-directionally. Linking your epics to launches in Luna will 1) give visibility to all stakeholders about upcoming launches and 2) allow you to save hours on reporting, by keeping Jira and Luna in sync.

## How can I connect to Jira

You can connect to Jira on any of the following pages:

* Sign up flow
* Create a new launch page
* Settings > Integrations page

By clicking on “link” on any of these pages, you will be redirected to the Jira oAuth flow, during which you will consent to the permission scope required by the integration.

The connection between Jira and Luna is a workspace to workspace connection. It’s enough for one user (preferably admin) to connect to Jira, for all users to be able to leverage the connection in Luna.

{% hint style="info" %}
If Jira doesn’t allow you to proceed with the permission flow, then your IT team will have to whitelist Luna.
{% endhint %}

## Configure your Jira integration in Luna

In the Settings > Integrations page, click on the Jira box to access all workspace configuration settings. In that page, you can configure Jira for your launches and milestones, separately.

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXfdaUfRiLil1f82OIS78s4R18oW6vy2rWHYkDksD4LZ-OJSUSSU_6D1YZcLu0gM-WNO20VhWS_4IW1rmVyThpu2J7OtTCI5D0Kb29JtCqoL_kZZjv3uhG0Hr8z5YdN8q1YtLvEg2QsJShRbaRQZBr9k5Yyu?key=vFToHcRzl46s99fckfz_GA" alt=""><figcaption></figcaption></figure>

### Choose a Jira project

At the workspace level, you can choose the where (Jira project) and in which form (issue type) a launch or milestone can be pushed in Jira.&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXe9IJKWpqXqPtFKpJz2pV99nIAsw-JB5UIOIgu7eXlAASBNKqnOHmFQEzeYjw8dpsjjjbn0W92gFlsT0RHUZRoRR9yeRPTiw5SnX71MiezjRSAPBeJ_2-kcMBLzEUlDA7cEfZ2MxNtmsYesRSRumhNxszad?key=vFToHcRzl46s99fckfz_GA" alt=""><figcaption></figcaption></figure>

### 2-way sync configurations

For each field mapping, you can configure the workspace level syncing settings:&#x20;

1. Sync from Jira to Luna only
2. Synd from Luna to Jira only
3. 2-way sync

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXdtnsA7wiNZyfjd_uSQOKLIZVAE041_uRscsMTkNy-0TYIUUh1Si2f-W8OoBRDGo9PBxS-N0R6fQW4YurTO23rl2PlsZN4oRLwWuYz6SMTyte23itLlm-mPZvVUM91OeL2ICdMC8jTmay9Ws3AiLvtWX-yY?key=vFToHcRzl46s99fckfz_GA" alt="" width="563"><figcaption></figcaption></figure>

### Configuration hierarchy&#x20;

All Jira configurations will cascade in the following order:&#x20;

1. **Workspace level**: any template or launch created will inherit workspace level Jira configurations
2. **Template level**: all launches created using the corresponding template, will inherit the template level Jira configuration
3. **Launch level**: all configurations will be proper to that launch

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXf_J9fWmP44H_x_0DMrdNGf5pQYKJ4PLCHAeUzZaBYw1Vfq5Rwgcc9lFAMst1YVcZ-RmbySPZaFOtGqZ1bG9XipHCsIA3M_HPU_HDAiHUCTPPxtgGzhk4cTHR67zsDvSmmTfC23HFp8h0ABDNZ4K9HVRiRZ?key=vFToHcRzl46s99fckfz_GA" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
New configurations are not applied to activities done previously. They only apply to activities performed after the configurations are set.
{% endhint %}

## How can I import and link issue(s) to launches in Luna

As a user, you can import any issue that is part of a project, such as: initiative, epic, story, task and bug. We recommend you to import issues which need some level of cross-functional and vertical collaboration and visibility.&#x20;

### Create a new launch from a Jira issue &#x20;

Click on ‘**+**’ → Jira import:&#x20;

* If you import one issue → you will be redirected to the launch detail page (LDP) of the imported issue
* If you import more than one issue → you will be redirected to to the All Launches page, which will display the issues you have imported&#x20;

### Link an existing launch to a Jira issue &#x20;

If you have previously created launches that were not imported from Jira, you can still link this existing launch to a Jira issue.&#x20;

In the LDP, click on **hamburger menu > Link launch**&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXc4dgbUzW0dJrwubfBPMSbSHyNOzrLxQOH2FWNqaZm3qkiEjMc8pLO4zkShzFYgwa9wpNVWyf62DZK8kTsHGQo1kxUS68OGAqyNCyhh_c0bX197PHPIXuDvWTF6sUdYhPE1HU6_yLOHDZZh60t1PX-acBOh?key=vFToHcRzl46s99fckfz_GA" alt="" width="188"><figcaption></figcaption></figure>

## How can I link Jira issues to a Luna template &#x20;

While importing issues from Jira, you can link one or more issues to a Luna template. This will allow you to create a more complete and streamlined launch, taking into consideration Jira data complemented with pre-defined modules in the template.&#x20;

When created, launch data will either come from the Jira issue ([data mapping table](https://docs.google.com/document/d/1M_uWd2Sh28gOrnpF8DKgVvD47yFflNSH8hQEx_kGqqs/edit#heading=h.qnhuo0hq31nh)) or from the template. Some fields clash between the two sources, here’s the import logic:&#x20;

<table><thead><tr><th width="139.87890625">Clashing field</th><th>Rule</th></tr></thead><tbody><tr><td>Summary</td><td><p>The summary section will consist of both the template and the Jira issue summaries. </p><p>After creation, the summary section will remain in sync with the Jira issue description, whenever a change is made. </p></td></tr><tr><td>Labels</td><td><p>Labels will be added from both the Jira issue and the template. </p><p>After creation, labels coming from Jira will sync as per the above mapping. Labels coming from the template will not be impacted.</p></td></tr><tr><td>Stages</td><td>Stages will consist of both template stages and Jira statuses. These stages can be reordered and recategorised into the correct Luna category in Settings >> Stage management</td></tr></tbody></table>

## What launch fields do you import/sync with Jira

The following fields will get imported in Luna and will stay in sync:

| Luna                                                                                                      | Jira issue                                                                               |
| --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Hamburger menu                                                                                            | Key                                                                                      |
| Title                                                                                                     | Summary                                                                                  |
| Summary                                                                                                   | Description                                                                              |
| <p>Owner</p><p>- If no assignee in Jira, then owner is the person importing the issue</p>                 | Assignee                                                                                 |
| <p>Actual launch date</p><p>- If no due date in Jira, then launch date is this quarter’s import date </p> | Due Date or Project target date                                                          |
| Actual start date                                                                                         | <p>Start date or Project start date<br><br>if not available then Issue creation date</p> |
| <p>Prio</p><ul><li>Low = Lowest, Low</li><li>Medium = Medium</li><li>High = Highest, High</li></ul>       | Priority                                                                                 |
| Hamburger menu                                                                                            | URL                                                                                      |
| Stage                                                                                                     | Status                                                                                   |
| Labels                                                                                                    | Labels                                                                                   |
| Label                                                                                                     | Fix version                                                                              |
| Label                                                                                                     | Sprint                                                                                   |
| Label                                                                                                     | Goal                                                                                     |
| Label                                                                                                     | Product area                                                                             |

## How can I import and link issue(s) to milestones in Luna

As a user, you can link your Jira issues to new or existing Luna milestones.&#x20;

### Create a new milestone from a Jira issue&#x20;

1. Create new milestones by importing one or more Jira issues into Luna
2. Click on the “Import from Jira” CTA, in the milestones module
3. From the Jira importer window, choose the Jira issue to import as milestone

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXdIuDo2DRoKj9BFU4QJiux6iSmZCudqhI1T9Ofa6jPMnfl9D7WzRqEOwOYAtBpAmjhj_iNRQpH5ivCfXO5K5FWlNUUiLufnsuRhxvn-HbCu_YluYmV7Wf3Gy-UFRbe2e4CdnXvcLAdES-TyxoUk1J5Yjd2I?key=vFToHcRzl46s99fckfz_GA" alt=""><figcaption></figcaption></figure>

### Link an existing milestone to a Jira issue

1. Click on the “Link milestone” CTA in the hamburger menu of an existing milestone

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXd7txTcZyf2GY3BfOSf9Dtmjm4w683OwLvv9eupChU4MC-mPhR96Y4FoWIyx4ak1aVHgfHyraC7_Ci1a1EqZ7ulE8OysmgEtwny96xq70YA5enZC7-1EiMA5zPSxsuMsp01YPaMxMs6ttR2wxA9HqVAeb0?key=vFToHcRzl46s99fckfz_GA" alt=""><figcaption></figcaption></figure>

2. From the Jira importer window, choose the Jira issue to link to the existing milestone

Milestones data will remain in sync with any changes made to their linked issue, in Jira

## What milestones fields do you import/sync with Jira&#x20;

The following fields will get imported in Luna and will stay in sync with the milestones fields:

| Luna - milestones                                                                         | Jira issues                                                                              |
| ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Hamburger menu                                                                            | See details                                                                              |
| Name                                                                                      | Summary                                                                                  |
| <p>Owner</p><p>- If no assignee in Jira, then owner is the person importing the issue</p> | Owner                                                                                    |
| Actual Target date                                                                        | Due Date or Project target date                                                          |
| Actual start date                                                                         | <p>Start date or Project start date<br><br>if not available then Issue creation date</p> |
| Stage                                                                                     | Status                                                                                   |
| Child issues                                                                              | List of linked child issues                                                              |

## How can I push launches and milestones into issues in Jira

### Manual push from Luna to Jira

At the LDP level, you can push the launch or milestone information as an issue in Jira:

1. Jira configs: define the Jira project and issue type that will be created in Jira
2. Click on the ‘Push to Jira’ at the launch or milestone level

| Push a launch                                                                                                                                                                                                                                        | Push a milestone                                                                                                                                                                                                                                     |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![](https://835963234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5GC95dyEWIR4VBlPCEqJ%2Fuploads%2FMslvaekJYNLsAOlsCl4O%2FScreenshot%202024-07-25%20at%2023.56.38.png?alt=media\&token=157d61ed-5e2e-4fc2-9e2f-f08fa2ceb721) | ![](https://835963234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5GC95dyEWIR4VBlPCEqJ%2Fuploads%2FKGapBDlgU6ZnoU4dxjrs%2FScreenshot%202024-07-25%20at%2023.56.43.png?alt=media\&token=25867768-ac87-4de9-b117-ae1f35d2d2f6) |

3. The corresponding issue will be created in Jira and linked with the Luna launch or milestone. Syncing will be performed according to the defined configuration

### Automated push from Luna to Jira

At the template or LDP level, you can define workflows what will automatically push the launch or milestone information as an issue in Jira:

1. Hamburger menu: click on ‘Set workflows’

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXcBBBlNLzgcn8Rsnby5J3FO_OUQu5ibggf7JQPUdJlmcB-y6Esu6wsmPeitwfiYz7Z74IUS44cUhYUV18gBUzkhgOIZqBFJU4c7l4SLk4NrOOsjIxjEvF9ai77L-IDsymALKFG62f9fy4pBeWMRWKwCN3l6?key=vFToHcRzl46s99fckfz_GA" alt=""><figcaption></figcaption></figure>

2. Define the milestone, workflow condition and action&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXfk5LMhbPP_FWsDWYngEVzNmVvxsKXWpNARuPcrmmSeXxLfCYgPqpZweALhK3Rv1cE-IMrfYNkWbfmEYI_0L_z1rxgHcwF3jEO4hCriL1DCO5uLT8JRAgS2QeoQ7OmQDflEd0oXuVDX6n07gYUlJS8Dqhoj?key=vFToHcRzl46s99fckfz_GA" alt=""><figcaption></figcaption></figure>

3. When the workflow is executed, the corresponding issue will be created in Jira and linked with the Luna launch or milestone. Syncing will be performed according to the defined configuration

## How can I turn on or off a launch or milestone sync with Jira

By default, syncing is enabled. In order to stop syncing your launch and milestones with Jira, you will need to opt out from the syncing option available in the LDP hamburger menu:&#x20;

* ‘Sync with Jira” enables or disables launch level sync with Jira
* ‘Sync milestones” enables or disables milestones sync with Jira

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXdf18Bhv6cheW68sCzLKcNbey2Ax5SkYinJP0oKnKFjZ6ze1RTxHhf-MzHZPfNv0tycF8qnMOD0qr2Oi55pFGt5VEHZmQxLFa2cnE3Dm9IHATiiLCpHMweKQ8mK-2Mk0dSiPWlHUzZFO3evcnNA3Z5rg8O2?key=vFToHcRzl46s99fckfz_GA" alt=""><figcaption></figcaption></figure>