> For the complete documentation index, see [llms.txt](https://docs.softwaresecured.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.softwaresecured.com/account/integrations/jira.md).

# Jira

Connect your most important Jira boards to streamline project management.

{% hint style="info" %}
Note: This integration is available with the Standard Plus package or above.
{% endhint %}

### **Prerequisites**

An account with <mark style="color:orange;">Org Admin</mark> permissions.

### Steps

{% stepper %}
{% step %}

#### Start the integration setup

1. In the <code class="expression">space.vars.product\_name</code> navigation sidebar, locate the <mark style="color:orange;">**Integrations**</mark> page near the bottom and open it
2. Find the Jira integration card, and then click <mark style="color:orange;">**Add Jira Account**</mark>**.**&#x20;
   {% endstep %}

{% step %}

#### Generate a Jira API token

1. Log in to your Jira account
2. Click your profile icon, and then click <mark style="color:blue;">**Manage Account**</mark>.
3. In the new window, click on the <mark style="color:blue;">**Security**</mark> tab and then click <mark style="color:blue;">**Create and manage API tokens**</mark>.
4. Create a new API token with a relevant name, such as <mark style="color:blue;">`Portal Integration Token`</mark>. Set a long expiry, but not too long; <code class="expression">space.vars.company\_name</code> recommends 1 year.
5. Copy the token.&#x20;
   {% endstep %}

{% step %}

#### Connect <code class="expression">space.vars.product\_name</code> to Jira

1. On <code class="expression">space.vars.product\_name</code>, continue enabling the integration.
2. In the server URL, enter the domain of your Jira tenant. The URL usually looks like the following example: <mark style="color:blue;">`<your-company>.atlassian.com`</mark>
3. Enter your Jira username and the API token from step 2, and then click <mark style="color:orange;">**Next**</mark>.

<figure><img src="https://3399686764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VRHlIPF1fbDuNbp9G2t%2Fuploads%2FOb3soc6zEDMgegKhloss%2FScreenshot%202026-04-01%20095207.png?alt=media&amp;token=d716859c-da87-4226-b610-820520ad6e6d" alt=""><figcaption><p>Add your Jira account that you want to integrate with Portal.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Select projects and boards

1. Select the Jira Project that you would like to connect. When creating tickets in Jira from vulnerabilities in <code class="expression">space.vars.product\_name</code>, they will be created in this project.
2. Select the <code class="expression">space.vars.product\_name</code> Project that you would like to connect to.<br>

   <figure><img src="https://3399686764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VRHlIPF1fbDuNbp9G2t%2Fuploads%2FYXgjg9jRqgAgWrFyce5n%2FScreenshot%202026-04-01%20095207.png?alt=media&amp;token=4365001e-7875-47a2-bff4-9aa75d15f58f" alt=""><figcaption><p>Choose the projects and boards to integrate. </p></figcaption></figure>

{% endstep %}

{% step %}

#### Configure field mapping

{% hint style="success" %}

#### Note

If you already have fields in Jira that match the name of the fields in <code class="expression">space.vars.product\_name</code>, they are automatically mapped to each other.
{% endhint %}

1. Select the Jira record type that you would like the integration to use when creating new records. You can select any record type from your project.&#x20;
2. If necessary, customize the field mapping by selecting different fields from the dropdown menus. <br>

   <figure><img src="https://3399686764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VRHlIPF1fbDuNbp9G2t%2Fuploads%2Fsu4n9I6G0Py6Ll0p3ua2%2FScreenshot%202026-04-01%20095207.png?alt=media&amp;token=94400580-de47-4e05-a4ef-19abcf7e6272" alt=""><figcaption><p>Choose which fields in Portal will populate which fields in Jira.</p></figcaption></figure>

{% endstep %}

{% step %}

#### Review and enable the integration

1. Review your integration configuration.&#x20;
2. To enable the integration, click <mark style="color:orange;">**Finish**</mark>.
   {% endstep %}
   {% endstepper %}

### Results

Use Jira to track remediation progress for your vulnerabilities. For more information, see [Using integrations to track remediation](/after-testing/remediating-vulnerabilities/using-integrations-to-track-remediation.md).&#x20;