---
title: Jira
description: Connect a Jira Cloud site to use issues as Knowledge context and let Ysra propose issue creation, updates, comments and transitions for your approval.
---

## Connect

1. **Workspace → Integrations → Jira → Connect**, and sign in to Atlassian.
2. If your account can see more than one Jira site, **choose the site** to
   connect. One connection covers one site.
3. The connection becomes **Ready** and starts its first sync.

## What gets synced

Issues with their key, project, summary, description, comments, status,
assignee, dates, parent and a link back to Jira. Rich issue text is converted to
readable text. Syncing resumes where it stopped and picks up changes on each run.

## Proposed changes

With an expert or worker allowed to propose Jira changes, Ysra can draft:

| Action | You'll see |
|---|---|
| **Create issue** | Project, summary, and optionally description, type, assignee, priority, labels, components, due date, parent. |
| **Update issue** | The fields that would change. |
| **Comment** | The issue and the comment text. |
| **Transition** | The issue and its new status. |

Nothing changes in Jira until you approve the exact proposal. Project keys,
issue keys and assignees come from your synced data or Jira lookup — never
guessed. See [Actions and approvals](../knowledge/actions.md).

## Disconnect

Disconnect from the connection's menu. Syncing stops; to revoke Ysra's access
completely, also remove it from your Atlassian account's connected apps.
