Key Takeaways
Linear Integration: Connect Linear's items with Craft.io's work items to structure product strategy effectively with Craft.io’s frameworks - planning, roadmaps, prioritization, feedback management, data and custom fields.
Integration Setup and Mapping: Use the integration wizard to connect your workspace to selected Linear teams, set up hierarchy and status mapping, and perform initial data syncing.
Real-time Updates: Use Webhooks for instant, automated updates between the systems, ensuring your roadmap always reflects the current development status.
Two-Way Visibility: Prioritize and plan in Craft.io, then sync items directly to Linear as actionable projects and issues, ready for the dev team.
For more detailed step by step guidance on setting up the integration, refer to the following two articles:
Linear Integration
Linear Integration is now part of Craft.io's dev tool native integrations. Linear is a rising new dev tool for AI-oriented and modern engineering and product teams.
However, while Linear is designed to be lean, product managers require additional strategic layers. Linear integration offers to connect and benefit from this gap, balancing the need for deep product structure with the need for engineering velocity. With the new integration, Craft.io users can build those strategic layers with custom fields for prioritization and planning, OKRs configuration, customer feedback management, roadmapping and more. This ensures that every ticket in the dev backlog is connected to a clear product goal, providing full context without slowing down the development cycle.
With this integration, users can sync Linear projects, issues and sub-issues directly into Craft.io’s workspace, enabling product managers to create a bridge between strategy and execution. This feature is currently in a closed beta group. We'd love to add you - please contact your dedicated CS manager.
Integration setup and Mapping
The Linear integration wizard offers a streamlined, step-by-step method to link your Craft.io workspace with selected Linear teams from a single Linear workspace.
To begin the integration process, first generate an API key within your Linear workspace. Then, utilize our integration wizard to:
Select Linear Teams: Choose the Linear teams you wish to include in the integration.
Configure Hierarchy Mapping: Define how Linear items map to Craft.io work items by choosing one of the following structures:
Map Linear projects to Craft.io epics, Linear issues to Craft.io features, and Linear sub-issues to Craft.io subtasks; or
Map Linear projects to Craft.io features and Linear issues to Craft.io subtasks.
Once these steps are complete, the integration will support API updates for the following fields for each mapped item: title, description, Linear ID, Linear team, labels, priority (which maps to Craft.io's Importance), status (which maps to Craft.io's Dev status), Lead (which maps to Craft.io's Dev assignee), Assignee (which also maps to Craft.io's Dev assignee), and project dependencies.
After the initial setup, you can also:
Configure Status Mapping: Set up a corresponding map between Linear and Craft.io work item statuses. Any status change in Linear will automatically reflect in the equivalent Craft.io work item.
Perform Initial Import: Execute a one-time synchronization to import items from Linear into Craft.io.
Real-time Updates
To ensure that your product data and roadmaps in Craft.io are always accurate and up-to-date, and to avoid manual updates, you should set up a webhook. This will automatically sync updates from Linear to Craft.io. Otherwise, you can not configure a webhook, and then the integration will only allow one-way syncing from Craft.io to Linear.
To set up the webhook, open the integration tab in Craft.io, click “Webhook setup” and follow the instructions to create the webhook within your Linear workspace.
Two-Way Visibility
Once the Linear integration setup is finalized, the sync function is ready for use. After completing product discovery and prioritization in Craft.io - potentially using advanced scoring models or AI-assisted feedback analysis - you can smoothly transition the work to your engineering team.
With a single click of the sync button (located under the dev status and Linear ID fields), prioritized features or epics can be sent directly from Craft.io into Linear. For large projects, you can also utilize the bulk sync option to efficiently deliver a detailed project plan to your dev team. Note that to ensure a successful sync of any item from Craft.io to Linear, you must first select a Linear Team that is one of the connection’s integrated teams.
