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

# Jira

> Connect Jira Cloud projects and issues to Kasava Products

Jira is Atlassian's enterprise issue tracking platform. Kasava integrates with Jira Cloud to bring your issues into Products and enable AI-powered issue management.

## Capabilities

| Feature             | Description                               |
| ------------------- | ----------------------------------------- |
| Issue Sync          | Import Jira issues to Products            |
| AI Chat Integration | Manage Jira issues using natural language |
| Project Mapping     | Link Jira projects to Products            |
| Status Sync         | Map Jira statuses to Kanban columns       |
| Field Mapping       | Sync standard and custom fields           |
| Sprint Tracking     | View sprint progress and velocity         |

<Note>
  Kasava currently supports **Jira Cloud** only. Jira Server and Jira Data Center are not supported at this time.
</Note>

## Connecting Jira

<Steps>
  <Step title="Navigate to Settings">
    Go to **Settings > Integrations** in the sidebar
  </Step>

  <Step title="Find Jira">
    In the **Task Management** section, locate the Jira integration card
  </Step>

  <Step title="Click Connect">
    Click the green **Connect** button to start the OAuth flow
  </Step>

  <Step title="Select Atlassian Site">
    If you have multiple Atlassian sites, select the one you want to connect
  </Step>

  <Step title="Authorize Access">
    Review the requested permissions and click **Accept** to authorize Kasava
  </Step>

  <Step title="Connection Complete">
    You'll be redirected back to Kasava with a "Connected Successfully" message. The Jira card will show a green connected status.
  </Step>
</Steps>

## What You Can Do Once Connected

After connecting Jira, you can:

* **Sync Jira issues to Products** - Link Jira projects to Kasava Products for unified views
* **Use AI chat for issue management** - Create and update issues using natural language
* **View issues in Kanban** - See Jira issues organized by status
* **Track sprints** - View sprint progress alongside other work

## Linking Jira to a Product

To sync Jira issues with a specific Kasava Product:

<Steps>
  <Step title="Open Product Settings">
    Navigate to your Product and click the settings icon
  </Step>

  <Step title="Add External Project">
    In the external projects section, click to add a new link
  </Step>

  <Step title="Select Jira">
    Choose "Jira" as the platform
  </Step>

  <Step title="Choose Project">
    Select the Jira project to sync from your connected site
  </Step>

  <Step title="Configure Mapping">
    Review field mappings and confirm the connection
  </Step>
</Steps>

### Field Mapping

When issues sync between Jira and Kasava:

| Jira Field   | Kasava Field  |
| ------------ | ------------- |
| Status       | Kanban column |
| Assignee     | Assignee      |
| Labels       | Labels        |
| Priority     | Priority      |
| Sprint       | Sprint        |
| Story Points | Story points  |
| Epic         | Parent issue  |

### Issue Types

Jira issue types are preserved:

| Jira Type | Display in Kasava |
| --------- | ----------------- |
| Story     | Story             |
| Bug       | Bug               |
| Task      | Task              |
| Epic      | Epic              |
| Sub-task  | Sub-task          |

Custom Jira issue types are imported with their original names.

## Status Mapping

Jira workflow statuses map to Kanban columns based on status category:

| Jira Status Category | Kanban Column |
| -------------------- | ------------- |
| To Do                | To Do         |
| In Progress          | In Progress   |
| Done                 | Done          |

### Custom Workflows

For projects with custom Jira workflows, you can configure status mapping in Product settings:

1. Open Product settings
2. Go to "Status Mapping"
3. Map each Jira status to a Kasava column
4. Save changes

<Tip>
  Group similar statuses into the same column for a cleaner Kanban view. For example, "Code Review" and "QA Testing" might both map to an "In Review" column.
</Tip>

## Working with Sprints

Jira sprints sync with Kasava Products:

* **View active sprint progress** - See what's being worked on now
* **Filter by sprint** - Focus on specific sprint issues
* **Track velocity** - Monitor team throughput over time

## Using Jira in AI Chat

Once connected, you can manage Jira issues using natural language in Kasava's chat:

**Example commands:**

* "Create a Jira bug for the payment processing error"
* "Show me all open Jira issues in the current sprint"
* "What's the status of the API redesign epic?"
* "Move PROJ-123 to In Progress"

## @kasava Commands in Issues

Use `@kasava` mentions in Jira issue comments to trigger AI-powered actions directly from your workflow.

### How It Works

1. Add a comment on any Jira issue with `@kasava` followed by a command
2. Kasava detects the mention via webhooks
3. The AI processes your request using the issue context
4. Results are posted as a reply comment on the issue

### Available Commands

| Command             | Description                                 |
| ------------------- | ------------------------------------------- |
| `@kasava summarize` | Summarize the issue discussion              |
| `@kasava collapse`  | Collapse lengthy discussions into a summary |
| `@kasava archive`   | Archive discussion with a summary           |

### Command Arguments

Filter the analysis with natural language:

```
@kasava summarize last 5 comments
@kasava summarize since last week
```

<Note>
  Jira `@kasava` commands currently support summarization-focused actions. Additional commands like `plan`, `design-doc`, and others are available on GitHub, Linear, and Asana integrations.
</Note>

### Authorization

Jira workspace members in your Kasava organization can use commands. The user adding the comment must have access to the issue.

## Managing the Connection

To manage your Jira connection:

<Steps>
  <Step title="Go to Settings > Integrations">
    Navigate to the integrations settings page
  </Step>

  <Step title="Find Jira">
    Locate the connected Jira card (green background)
  </Step>

  <Step title="Click Manage">
    Click the **Manage** button to open the management dialog
  </Step>
</Steps>

From the management dialog, you can:

* View connection status
* See the connected Atlassian site
* Disconnect the integration

## Disconnecting Jira

<Steps>
  <Step title="Open Jira Management">
    Go to **Settings > Integrations** and click **Manage** on the Jira card
  </Step>

  <Step title="Click Disconnect">
    Click the **Disconnect** button
  </Step>

  <Step title="Confirm">
    Confirm that you want to disconnect
  </Step>
</Steps>

<Note>
  Disconnecting Jira removes Kasava's access to your Jira site. Any linked Products will no longer sync with Jira projects. Your Jira data is not deleted.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Project not appearing in the list">
    Ensure you have access to the project in Jira. Check that your Atlassian OAuth token is still valid. Try disconnecting and reconnecting the integration.
  </Accordion>

  <Accordion title="Issues not syncing to my Product">
    Verify that the Jira project is linked to your Product in Product settings. Check that the sync is enabled and the connection shows as active.
  </Accordion>

  <Accordion title="OAuth authorization failed">
    If you see an error after authorizing, your Atlassian account may not have permission to authorize third-party apps. Contact your Jira administrator if needed.
  </Accordion>

  <Accordion title="Status changes not reflecting">
    Some Jira workflows have required fields or conditions for status transitions. If a transition fails, check the workflow requirements in Jira.
  </Accordion>
</AccordionGroup>

## Permissions

Kasava requests these Jira permissions during OAuth:

| Permission            | Purpose                                    |
| --------------------- | ------------------------------------------ |
| Read Jira work        | View issues, projects, sprints, and boards |
| Write Jira work       | Create and update issues                   |
| Read user information | Access user profiles for assignee mapping  |

## Security

* OAuth tokens are encrypted at rest
* Tokens are never exposed in the UI
* Disconnect anytime from Kasava or Atlassian's settings
* No passwords stored

## Related

<CardGroup cols={2}>
  <Card title="Products" icon="layer-group" href="/docs/features/products">
    Link Jira projects to Products
  </Card>

  <Card title="AI Chat" icon="message-circle" href="/docs/features/ai-chat">
    Use chat to manage Jira issues
  </Card>

  <Card title="Linear Integration" icon="square-check" href="/docs/integrations/linear">
    Alternative: Connect Linear
  </Card>

  <Card title="Integrations Overview" icon="plug" href="/docs/integrations/overview">
    All available integrations
  </Card>
</CardGroup>