Jira Integration

Connect Jira when your team plans delivery in Jira but wants Projects in Deck to stay grounded in customer evidence.

With Jira connected, Deck can import Jira Epics into Projects, link existing Projects to Jira Epics, and create Jira Epics from Deck Project context.

What You Can Do

• import an existing Jira Epic as a Deck Project
• link an existing Deck Project to a Jira Epic
• create a new Jira Epic from a Deck Project
• choose Jira Projects, workflow statuses, and assignable users during handoff
• keep the Deck Project connected to the Jira Epic URL and status snapshot

Deck uses Jira Projects as containers for Epics. Deck Projects link to Jira Epics, not Jira Projects.

Connect Jira

1. Go to Settings -> Integrations.
2. Open the Jira integration.
3. Click Connect.
4. Complete the Atlassian authorization flow.
5. Return to Deck and open Build -> Projects.

After connecting, Jira options appear in Project import and external handoff menus.

Import a Jira Epic

1. Open Build -> Projects.
2. Choose the Jira import option.
3. Select a Jira Epic.
4. Optionally choose the initiative the Project should belong to.
5. If segments are enabled, optionally choose the segment for the Project.
6. Confirm the import.

Deck creates a new Project and copies mappable fields such as the title, description, status, owner, dates, and Overview content when available.

Create a Jira Epic From Deck

1. Open a Deck Project.
2. Open the external handoff menu.
3. Choose the Jira create option.
4. Select the Jira Project that should contain the Epic.
5. Choose available owner, priority, and status details.
6. Optionally generate an editable AI overview from the Deck Project context.
7. Create the Epic.

Deck then stores the Jira Epic link on the Project.

Important Behavior

• A Deck Project can have one external execution link at a time.
• A Jira Epic can be linked to one Deck Project per organization.
• Unlinking removes only the Deck-side link. It does not delete or change the Jira Epic.
• Deck does not continuously sync every Jira field after import or link. Treat copied fields as a snapshot unless you explicitly apply updates in Deck.