# JIRA

## Configuring JIRA

#### Pre-requisites

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

**Helpful Links**

{% content-ref url="/pages/9E9NQhwIg1plgHh2NFf5" %}
[Create a Company Account](/company-guide/create-a-company-account.md)
{% endcontent-ref %}

{% content-ref url="/pages/gt84QZChY5gJbxytLzR1" %}
[Programs at BugBase](/overview/programs-at-bugbase.md)
{% 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="/files/a8ZT5f4zDMKq5Mg38hBJ" 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="/files/K6HanfHukx35RmzVOmcu" 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="/files/AvotrcjVILCHNdoURNoY" 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="/files/oYOZkywqWGIZSZzRGv2J" 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="/pages/fA6sihAjij8TFbXgZ4sg" %}
[Creating a JIRA Issue](/integrations/jira/creating-a-jira-issue.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bugbase.ai/integrations/jira.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.