---
title: "Install and use the Jira-to-ForeSight plugin"
slug: "how-to-install-the-panaya-foresight-jira-plugin"
updated: 2025-01-27T09:45:19Z
published: 2025-01-27T09:45:19Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://success.panaya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install and use the Jira-to-ForeSight plugin

## **Install and configure the Jira Plugin**

1. As a JIRA Administrator go to Settings Apps **Explore more apps** - ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-LIM7C2I9.png)

1. Enter ‘**Panaya ForeSight’** in the Search window to search the Marketplace and click on the ForeSight plugin download link - ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-UJXL273I.png)

1. Click on **Get app** on the plugin page and **Get it Now** to download the app - ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-O8R96RKA.png) ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-16W93JDB.png)

1. On the Success screen, click on **Configure** to get to the Configuration page - ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-S52ORAHX.png)

Alternatively, click on **Manage apps** to find **Panaya ForeSight for JIRA** under User-installed apps and click on **Configure** - ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-40C0XHFG.png)
2. Enter the **Configuration** Credentials and click **Save** -

- **API User**: your Panaya username (**email address**)
- **Panaya Token**: Review the article [How to create your token](/v1/docs/how-to-create-your-token) to generate it, and copy-paste it into the box
- **Panaya Region**: The Region where your Panaya account is located:
  - **US**if you log in using **my.panaya.com**
  - **EMEA**if you log in using **emea.panaya.com**

![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-Z2EEEA78.png)
- Foresight Configuration: click **Next**. ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-FZSMUF1V.png)
- Enter the **Panaya projects**related to **the Jira projects** and click **Save** - ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-RJDCOJE4.png)

## **How to use the Jira Plugin**

1. Login to a JIRA project configured in **Step 6**, create a JIRA issue and click on**Metadata components.**

![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-EA6AOCEM.png)
2. Click on **Click here** to start adding Salesforce components to the issue - ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-NEFKDBI7.png)
3. Select a **Type**, enter a text string for the component **Name,** and click on **Search**to retrieve one or more components matching the criteria - ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-63O50L7J.png)
4. Click the checkboxes to select desired components from the list and click on **Add.** ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-62FZLMMX.png)
5. Click on **+Add** or **Remove** to include or remove components from the list. When ready, click on the **Analyze**button to launch the Panaya analysis - ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-7H7Q592M.png)

## **The result**

1. A new **Analysis** is created in the **Workspace** in the related Panaya project (from Step 6) with a default name format of <JIRA Issue title>.
2. In JIRA the number of **Impacted** and **Impacting** **Components** will be displayed for each component based on the Panaya analysis.
3. The JIRA story and linked Panaya analysis are synchronized.

![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-9GYPPJMN.png)
  1. Any addition or removal of components in one platform will automatically synch with the other.
  2. The number of Impacting and Impacted Components in the JIRA story will automatically update every time the analysis is launched from JIRA or Panaya.