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 Deck connected to Linear URLs and top-level status metadata

Connect Linear

1. Go to Settings -> Integrations.
2. Open the Linear integration.
3. Click Connect.
4. Complete the Linear authorization flow.
5. 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

1. Open Build -> Initiatives.
2. Open the New menu.
3. Choose Import from Linear.
4. Select a Linear Initiative.
5. If segments are enabled, optionally choose the segment for the imported Initiative and child Projects.
6. 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

1. Open Build -> Projects.
2. Choose the Linear import option.
3. Select a Linear Project.
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.

Link an Existing Deck Project

1. Open the Deck Project.
2. Open the external handoff menu.
3. Choose the Linear link option.
4. Select a Linear Project.
5. Link the Project.

Deck stores the Linear link and fills only empty execution metadata from Linear. If the Deck Project is still Not started, Deck can update its status from the Linear status. If the Deck Project has no start date or target date, Deck can fill those dates from Linear. Deck does not overwrite the Project title, owner, description, segments, Overview, Evidence, or Success Metrics during linking.

Create a Linear Project From Deck

1. Open a Deck Project.
2. Open the external handoff menu.
3. Choose the Linear create option.
4. Select the Linear team and owner details.
5. Optionally set status, priority, start date, and target date.
6. Optionally generate an editable AI overview from the Deck Project context.
7. 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.
• Linking an existing Deck Project fills only empty or default execution fields from Linear. Full title, description, owner, segment, and document overwrites are not part of the link flow.
• Deck refreshes provider-owned top-level metadata daily for linked Linear Projects and Linear Initiatives, including title, description, owner, dates, status, completion time, and linked Linear URL/title.
• Deck does not sync Linear child relationships after import. Project and Initiative documents, evidence, outcomes, and generated sections remain Deck-owned and are not overwritten by Linear sync.