How to Integrate Figma with Linear (Step-by-Step)
Connecting Figma to Linear gives engineers direct access to designs from their sprint issues and gives designers visibility into when design-complete stories are picked up for engineering. The integration reduces the time engineers spend hunting for the right Figma frame and eliminates the "which version of the design should I implement?" ambiguity.
This guide covers the Figma-Linear integration setup, design handoff conventions, and automation for keeping design status in sync with issue status.
Step-by-step guide
Install the Linear integration in Figma
In Figma, go to Resources (Shift+I) > Plugins > search "Linear." Install the official Linear plugin by Linear. Authorize it with your Linear account. The plugin appears in your Figma plugins list and allows you to link Figma frames to Linear issues and create Linear issues directly from Figma.
Link Figma frames to Linear issues
In Figma, select any frame. Open the Linear plugin. Search for the Linear issue by ID or title (e.g., "ENG-123" or "OAuth login button"). Click "Link to issue." The Linear issue now shows a Figma attachment in its detail view. In Linear, click the Figma attachment to open the frame directly in Figma for inspection.
Add Figma URLs to Linear issues
Alternatively, from the Linear issue side: open the issue > click the Figma icon in the attachments section > paste the Figma frame URL (right-click any frame in Figma > "Copy link to selection"). This creates a clickable preview of the Figma frame within the Linear issue. Engineers see the design at a glance without opening Figma.
Create Linear issues from Figma
In Figma, select a frame that needs engineering work. Open the Linear plugin > "Create issue." The plugin pre-fills the issue with the frame title. Add description, assignee, and priority. A new Linear issue is created and linked to the Figma frame. This is the designer-initiated handoff workflow: designers flag frames that are ready for engineering.
Use Linear labels for design status
In Linear, create labels: "Needs Design," "Design In Progress," "Design Review," "Design Complete." Set issues to "Needs Design" when the story is created. Designers update to "Design In Progress" when working on it and "Design Complete" when ready. Engineers filter the sprint board to "Design Complete" to see stories they can pick up.
Set up design-to-engineering handoff workflow
Define the handoff ritual: Designer marks Linear issue as "Design Complete" + attaches the final Figma frame URL + leaves a comment "Design ready, see [Figma link]. Key decisions: [list any non-obvious design choices]." Engineer acknowledges in the comments and moves the issue to "In Progress." This explicit handoff prevents engineers from starting on incomplete designs.
Configure Linear notifications for design status changes
In Linear Team Settings > Notifications, set up label-change notifications: when an issue label changes to "Design Complete," notify the engineering lead or the Slack #engineering channel. This automatic signal means engineering does not need to poll for design-ready stories.
Common mistakes
Linking the Figma file URL instead of a specific frame
A file-level Figma link requires engineers to hunt for the right screen inside the file. Always link at the frame level — right-click the exact frame > "Copy link to selection." Frame-level links open directly to the design.
Not updating the Figma link when designs change
If a design is revised significantly after engineering starts, update the Linear issue with the new Figma frame link and leave a comment noting what changed. Stale links are worse than no links — they cause engineers to implement outdated designs.
Skipping the handoff comment
Attaching a Figma link is the minimum handoff. The highest-value additions are: design decision notes (why this interaction, not that one), edge case documentation (what happens on mobile, on error), and open questions to resolve before implementation.
Tips
Use Figma's Dev Mode (paid plan) to give engineers a no-account-required inspection link for exact pixel values
Create a Figma component library link in the Linear team description so engineers always know where shared components live
Use Linear's bulk label update to mark all sprint-start stories as "Needs Design" in one action
Review design-complete labels weekly in the PM standup to ensure handoff is not creating a bottleneck
How Vantage helps
Vantage integrates with Figma to import designs as context for PRD generation. Frames added to a Vantage project are analyzed for UI patterns, component requirements, and interaction flows. This context improves the specificity of generated requirements — turning design intent into engineering requirements automatically.