Linear Integration

Connect Linear when your team manages delivery in Linear and wants Deck Initiatives and Projects to stay tied to customer evidence.

With Linear connected, Deck can import Linear Initiatives and their child Projects, import individual Linear Projects, link existing Deck Projects to Linear Projects, and create Linear Projects from Deck Project context.

What You Can Do

import a Linear Initiative as a Deck Initiative
import the child Linear Projects from that Initiative as Deck Projects
import an existing Linear Project as a Deck Project
link an existing Deck Project to a Linear Project
create a new Linear Project from a Deck Project
choose Linear teams, owners, statuses, priorities, and dates during handoff
keep the Deck Project connected to the Linear Project URL and status snapshot

Connect Linear

Go to Settings -> Integrations.
Open the Linear integration.
Click Connect.
Complete the Linear authorization flow.
Return to Deck and open Build -> Initiatives or Build -> Projects.

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

Import a Linear Initiative

Open Build -> Initiatives.
Open the New menu.
Choose Import from Linear.
Select a Linear Initiative.
If segments are enabled, optionally choose the segment for the imported Initiative and child Projects.
Confirm the import.

Deck creates a new Initiative, stores the Linear Initiative link, and imports child Linear Projects under the new Initiative when those Projects are not already linked in Deck. Already-linked child Projects are skipped and reported after import.

Import a Linear Project

Open Build -> Projects.
Choose the Linear import option.
Select a Linear Project.
Optionally choose the initiative the Project should belong to.
If segments are enabled, optionally choose the segment for the Project.
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 Linear Project From Deck

Open a Deck Project.
Open the external handoff menu.
Choose the Linear create option.
Select the Linear team and owner details.
Optionally set status, priority, start date, and target date.
Optionally generate an editable AI overview from the Deck Project context.
Create the Linear Project.

Deck then stores the Linear Project link on the Project.

Important Behavior

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

Linear