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

# Jira

> Connect Jira to Rocket and build from your tickets. Rocket reads descriptions, acceptance criteria, sprint data, and epics to generate aligned code.

export const LlmsDirective = () => <blockquote className="llms-directive">
    For the complete documentation index, see <a href="/llms.txt">llms.txt</a>.
    For a lightweight markdown version of this page, append .md to the URL.
  </blockquote>;

<LlmsDirective />

Connect Jira and your tickets become build context. Rocket reads issue descriptions, acceptance criteria, epics, and sprint data directly from your board, then generates code that reflects your actual project requirements.

<Note>
  This connector is only available for **Next.js TypeScript** web build tasks.
</Note>

<Divider />

## What you can do

<CardGroup cols={2}>
  <Card title="Build from a ticket" icon="ticket">
    Paste a Jira issue URL into chat. Rocket reads the summary, description, and acceptance criteria, then generates the implementation.
  </Card>

  <Card title="Build from an epic" icon="diagram-project">
    Paste a Jira epic URL. Rocket reads all child stories and the epic description, then builds the full scope.
  </Card>

  <Card title="Use sprint context" icon="arrows-spin">
    Reference your current sprint. Rocket reads active stories and priorities to understand what you are building right now.
  </Card>

  <Card title="Fix bugs from reports" icon="bug">
    Paste a bug ticket URL. Rocket reads the steps to reproduce, expected vs actual behavior, and generates a targeted fix.
  </Card>

  <Card title="Pull ticket copy into your app" icon="clipboard-list">
    Use feature descriptions, value propositions, and requirements text from tickets directly in your app's UI.
  </Card>

  <Card title="Align code to workflows" icon="sitemap">
    Rocket understands Jira workflow states. It generates code that maps to your ticket statuses and transitions.
  </Card>
</CardGroup>

<Divider />

## Connect Jira

Jira uses OAuth 2.0 via Atlassian, so no API key is needed. It is a **workspace-level** connector — connect it once and it is available across all tasks.

The connection flow has two steps:

<Steps>
  <Step title="Authorize Atlassian">
    Authorize access to your Atlassian account.
  </Step>

  <Step title="Select App and Project">
    Select a **Jira App** (cloud instance) and a **Project** within that app.
  </Step>
</Steps>

<Tabs>
  <Tab title="Web Browser">
    You can connect from three places. All do the same thing.

    **Option 1: From chat**

    Paste a Jira ticket URL or ask Rocket to pull tickets. Rocket detects the intent and shows a **Connect** button inline. Click it to start the authorization flow.

    <Frame caption="Jira connection prompt in chat">
      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/6Y4VESVaDs1mZwnA/images/build-docs/connectors/jira/web-browser/jira-chat-light.webp?fit=max&auto=format&n=6Y4VESVaDs1mZwnA&q=85&s=fe58db756222ded3bbd5712f0448d7f6" alt="Rocket chat panel showing a Connect prompt for Jira." className="theme-image light-image" width="2880" height="1800" data-path="images/build-docs/connectors/jira/web-browser/jira-chat-light.webp" />

      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/6Y4VESVaDs1mZwnA/images/build-docs/connectors/jira/web-browser/jira-chat-dark.webp?fit=max&auto=format&n=6Y4VESVaDs1mZwnA&q=85&s=69824b47f136610b80bd9e36e49be987" alt="Rocket chat panel showing a Connect prompt for Jira." className="theme-image dark-image" width="2880" height="1800" data-path="images/build-docs/connectors/jira/web-browser/jira-chat-dark.webp" />
    </Frame>

    **Option 2: From the Connectors tab**

    Click the **`...`** button in the preview toolbar, then select **Connectors**.

    <Frame caption="Open Connectors from the toolbar">
      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/2lqYWidv_xVHKfL6/images/build-docs/connectors/shared/connectors-tab-open-light.webp?fit=max&auto=format&n=2lqYWidv_xVHKfL6&q=85&s=7bd785a0e878564054e08328b2aa3d6b" alt="Toolbar dropdown with Connectors option highlighted." className="theme-image light-image" width="2880" height="1624" data-path="images/build-docs/connectors/shared/connectors-tab-open-light.webp" />

      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/2lqYWidv_xVHKfL6/images/build-docs/connectors/shared/connectors-tab-open-dark.webp?fit=max&auto=format&n=2lqYWidv_xVHKfL6&q=85&s=d047040372d776cb47e4e483de8eeb8d" alt="Toolbar dropdown with Connectors option highlighted." className="theme-image dark-image" width="2880" height="1624" data-path="images/build-docs/connectors/shared/connectors-tab-open-dark.webp" />
    </Frame>

    Click the **Jira** card, then click **Connect**.

    <Frame caption="Jira card in the Connectors panel">
      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/6Y4VESVaDs1mZwnA/images/build-docs/connectors/jira/web-browser/jira-connectors-tab-light.webp?fit=max&auto=format&n=6Y4VESVaDs1mZwnA&q=85&s=a5bb7687feaed6a60967a55bc48099e5" alt="Connectors panel showing the Jira card with a Connect button." className="theme-image light-image" width="1810" height="562" data-path="images/build-docs/connectors/jira/web-browser/jira-connectors-tab-light.webp" />

      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/6Y4VESVaDs1mZwnA/images/build-docs/connectors/jira/web-browser/jira-connectors-tab-dark.webp?fit=max&auto=format&n=6Y4VESVaDs1mZwnA&q=85&s=40f998973f36f221686686cff20b1c3f" alt="Connectors panel showing the Jira card with a Connect button." className="theme-image dark-image" width="1810" height="562" data-path="images/build-docs/connectors/jira/web-browser/jira-connectors-tab-dark.webp" />
    </Frame>

    **Option 3: From workspace Settings**

    <Card title="Connect from workspace Settings" icon="plug" href="/getting-started/workspace/connectors" horizontal arrow="true">
      Connect once from Settings and it is available across all tasks.
    </Card>

    **After clicking Connect**

    An Atlassian authorization screen opens. Select your Jira cloud instance (App) from the **Use app on** dropdown, review the permissions, and click **Accept**.

    <Frame caption="Atlassian OAuth authorization screen">
      <img src="https://mintcdn.com/dhiwisepvtltd-5e04e6a4/6Y4VESVaDs1mZwnA/images/build-docs/connectors/jira/oauth-authorize.webp?fit=max&auto=format&n=6Y4VESVaDs1mZwnA&q=85&s=1b74266c8d4102785dffb6d0f73ecfb0" alt="Atlassian OAuth screen showing Rocket requesting access to your Jira account." className="theme-image" width="844" height="1594" data-path="images/build-docs/connectors/jira/oauth-authorize.webp" />
    </Frame>

    After authorizing, select the **Project** you want Rocket to read from.

    A green dot appears next to Jira when the connection is active.

    **Disconnect**

    <Card title="Disconnect a service" icon="plug" href="/getting-started/workspace/connectors#disconnect-a-service" horizontal arrow="true">
      Disconnect or switch accounts from workspace Settings.
    </Card>
  </Tab>

  <Tab title="Mobile App">
    You can connect from two places. Both do the same thing.

    **Option 1: From chat**

    Paste a Jira ticket URL or ask Rocket to pull issues. Rocket shows a **Connect** button inline. Tap it to start the authorization flow.

    **Option 2: From the Connectors tab**

    <Steps>
      <Step title="Open More menu">
        Tap the **More** button in the header.
      </Step>

      <Step title="Open Integrations">
        Tap **Integrations**.
      </Step>

      <Step title="Connect Jira">
        Tap the **Jira** card, then tap **Connect**.
      </Step>
    </Steps>

    **After tapping Connect**

    An Atlassian authorization screen opens. Review the permissions and tap **Accept**.

    **Select your App and Project**

    After authorizing, select your Jira cloud instance (App) and the Project you want Rocket to read from.

    A green dot appears next to Jira when the connection is active.
  </Tab>
</Tabs>

<Divider />

## Example prompts

Replace `[JIRA_URL]` with your actual issue, epic, or board URL.

### Reading from Jira

| What you want                 | Prompt to use                                                                                                                           |
| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- |
| Build a feature from a ticket | `Build the feature described in [JIRA_URL]. Read the full requirements, acceptance criteria, and subtasks before generating.`           |
| Build from an epic            | `Read the Jira epic at [JIRA_URL] and build all the screens and features described in its child stories.`                               |
| Fix a bug from a report       | `Fix the bug described in [JIRA_URL]. Read the steps to reproduce, expected behavior, and actual behavior and generate a targeted fix.` |
| Pull sprint context           | `Read my current sprint tickets and build the highest-priority story first.`                                                            |
| Apply requirement changes     | `The requirements changed in [JIRA_URL]. Read the updated description and modify the relevant parts of the app.`                        |
| Display a project board       | `Pull my Jira tickets into a dashboard that shows the current sprint board with status columns.`                                        |

<Divider />

## Tips

* **Be specific in your tickets.** Rocket builds from what is written. Tickets with detailed descriptions, clear acceptance criteria, and story points produce better output than vague ones.
* **Use issue URLs, not ticket keys alone.** Pasting a direct URL gives Rocket unambiguous context. Referring to a ticket by key alone can be ambiguous across projects.
* **Scope to a single project.** During connection you select one project. If you need to reference a different project, reconnect from workspace Settings.
* **Permissions apply.** Rocket respects Jira's access controls. It can only read issues and data that the connected Atlassian account has permission to access.
* **Works with Jira Cloud only.** This connector uses Atlassian's cloud OAuth. Self-hosted Jira Server and Data Center instances are not supported.

<Divider />

## What's next?

<CardGroup cols={2}>
  <Card title="Linear" icon="list-check" href="./linear">
    Already using Linear? Connect it for bi-directional ticket integration.
  </Card>

  <Card title="Confluence" icon="book" href="./confluence">
    Connect Confluence to pull product specs and documentation as build context.
  </Card>

  <Card title="GitHub" icon="github" href="/build/connectors/github/overview">
    Push your code to a repository and keep version history.
  </Card>

  <Card title="All connectors" icon="plug" href="/build/connectors/overview">
    Browse every available integration.
  </Card>
</CardGroup>
