# JIRA

## Configuring JIRA

#### Pre-requisites

* JIRA Account with an Active Project
* BugBase Company Account with an Active Program

**Helpful Links**

{% content-ref url="../company-guide/create-a-company-account" %}
[create-a-company-account](https://docs.bugbase.ai/company-guide/create-a-company-account)
{% endcontent-ref %}

{% content-ref url="../overview/programs-at-bugbase" %}
[programs-at-bugbase](https://docs.bugbase.ai/overview/programs-at-bugbase)
{% endcontent-ref %}

#### Setup

> Before starting the setup, ensure you are logged into your JIRA Account and have alteast 1 project in your account.

1. Navigate to the integrations tab located in the settings page of your BugBase Program. Alternatively you can use the following link: [`https://bugbase.in/company/settings/integrations`](https://bugbase.in/company/settings/integrations)

<figure><img src="https://docs.bugbase.in/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Fsettings.c54b05c8.png&#x26;w=3840&#x26;q=75" alt=""><figcaption></figcaption></figure>

1. Click on the `Toggle Button` on the JIRA Integration Card.
2. A popup asking to connect to your JIRA account will appear. Click on the `Connect` button to proceed with the connection.

   <figure><img src="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FWqAUvYDw8fVdMrqhMNyY%2Fimage.png?alt=media&#x26;token=57080666-d92e-4a0c-97e4-c2f5efe3c44d" alt=""><figcaption></figcaption></figure>
3. Once clicked, you will be redirected to the Atlassian OAuth page when you would be requested access to your JIRA account.<br>

   <figure><img src="https://docs.bugbase.in/_next/image?url=%2F_next%2Fstatic%2Fmedia%2Frequest.2a0e4a83.png&#x26;w=1920&#x26;q=75" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FET1iPhWDNozVlIkKxBXF%2Fimage.png?alt=media&#x26;token=060b5bf6-9530-4499-b9c7-f1d4971b20ba" alt=""><figcaption></figcaption></figure>
4. Click on the `Accept` button to give access to BugBase to be able to enable the integration.
5. If everything went well, you will be redirected to BugBase settings page and the JIRA integration will be enabled.

<figure><img src="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2F3249To0dDGNc6LjUZMP5%2Fimage.png?alt=media&#x26;token=e85a9866-7875-4a6a-a526-937e5c21ea1e" alt=""><figcaption></figcaption></figure>

#### Configuring the JIRA URL, Project, Issue Type & Cross-Sync Configuration

> Before starting the configuration, ensure you have connected your JIRA Account with your BugBase Account.

1. Navigate to the integrations tab located in the settings page of your BugBase Program.
2. Click on the `Configure` Button on the JIRA Integration Card
3. A popup will appear with some pre-filled fields, enter the URL of your JIRA instance, select the project and issue type you want to use.

<figure><img src="https://1542818622-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsYaOURvSKmQ57SN2CBT%2Fuploads%2FbyctEU3DPp2Mqzox7Xo9%2Fimage.png?alt=media&#x26;token=611487c3-80c0-49b7-b63b-721aef8ef6a0" alt=""><figcaption></figcaption></figure>

* The URL should be the URL of your JIRA instance.
* The project should be the project you want to use.
* The issue types will be automatically populated from your JIRA instance.
* The Cross-Sync State, if you want [Cross Sync ](#cross-sync)to be enabled or disabled

4\. Click on `Save` and the JIRA Integration will be configured.

### JIRA Cross Sync

Enabling Cross Sync on your BugBase JIRA Configuration will update any changes on your JIRA board on BugBase and vice-versa. This includes adding comments on a particular issues, changing stauses, assigning members on an issue etc.

{% hint style="success" %}
:tada: Congratulations! You've successfully connected **JIRA** with your **BugBase Program**
{% endhint %}

### Up Next

{% content-ref url="jira/creating-a-jira-issue" %}
[creating-a-jira-issue](https://docs.bugbase.ai/integrations/jira/creating-a-jira-issue)
{% endcontent-ref %}