Dependencies help teams understand how work items relate to each other, identify blockers, and manage scheduling risk across your roadmap.
Key takeaways
Quickly see how work items connect and where blockers exist
Understand whether items are related, blocking, or blocked
Show or hide dependencies depending on your audience
Sync dependencies with Jira or Azure DevOps
What are dependencies in Craft.io?
Dependencies describe the relationships between work items. They let you define whether items are connected, one is blocking another, or work needs to finish before something else can start.
Dependencies exist at the item level, which means they follow the item across every view in Craft.io, including:
Timeline
Table
Kanban
Swimlanes
Capacity Planning
This ensures that dependency relationships remain visible regardless of how your team chooses to view or manage their roadmap.
Dependency types
Craft.io supports three core dependency types, each describing a different kind of relationship between two items:
Related: Two items are connected but can be worked on in parallel. No scheduling constraint.
Blocked by: The item cannot start until the blocking item is complete. This is a hard scheduling dependency.
Blocks: The inverse of Blocked By. The item is preventing another from starting. The relationship is visible from both sides automatically.
Dependencies can be created at any item level regardless of hierarchy - an Epic can block a Feature, or a Story can block an Epic.
Managing dependencies
Because dependencies are stored on the item, they can be surfaced in multiple views across Craft.io. Craft.io makes it easy to create and manage dependencies in all of your Workspace and Portfolio views.
Item properties panel
The item properties panel is the central place to view, add, edit, or remove dependencies.
Open any item
Navigate to the Dependencies tab
Click + to search for an existing item and select the type of dependency.
Here you can:
View all related items
Add new dependencies
Modify dependency types
Identify blockers and conflicts
Table view
Dependencies can be displayed as a column in Table view, making it easy to track blockers across many items at once.
Select + or Column to add a new column into view
Tick Dependencies from the list
Like other fields, dependencies support sorting and filtering, which means you can build a dedicated view that surfaces all items with active blockers or a high number of relationships.
Timeline view
The Timeline view provides the most visual representation of dependencies. Dependency lines connect items directly on the roadmap, making relationships and scheduling risks immediately visible.
To visualize dependency lines:
Open View Settings
Toggle Present dependencies
Kanban and Swimlane views
Kanban and Swimlane views can display a dependency count icon on cards through the card layout settings. This allows teams to quickly understand whether an item has dependencies without leaving the board.
While these views do not display dependency lines like the Timeline view, the dependency data remains fully accessible through the item properties panel and layout.
Dependency status and conflict indicators
Craft.io surfaces dependency status visually across all views.
Status indicators
Dependency icons change color depending on the item’s status.
Red: The item is blocked by an incomplete dependency
Black: All blockers are complete
This allows teams to identify blocked work at a glance.
Delay warnings
When a blocking item is incomplete and scheduled to finish after the blocked item's end date, a delay warning appears in the Dependencies panel. This gives teams an early signal to reprioritize or adjust dates before a conflict impacts delivery.
Conflict lines on the Timeline
The Timeline view provides additional visual signals for dependency conflicts.
Solid red line: Dependency order is correct
Dotted red line: A scheduling conflict exists
A dotted line indicates the blocked item is scheduled to begin before its blocker finishes. These indicators update automatically as item dates change.
Syncing dependencies with development tools
Keeping dependencies aligned between your planning tool and your development tool ensures that the relationships defined during roadmap planning are reflected where engineers do their day-to-day work.
Jira: Two-way sync. Craft.io dependency types map directly to Jira issue link types (Blocks, Is blocked by, Related). Works with both Company Managed and Team Managed projects.
Azure DevOps: Two-way sync. Craft.io types map to ADO link types: Related → Related, Blocks → Predecessor, Blocked by → Successor.
Dependencies automatically synchronize between tools - this does not need to be manually mapped when you create an integration between Craft.io and Jira or Azure DevOps
Managing cross-workspace dependencies
For organizations with multiple workspaces, inter-workspace dependencies make cross-team relationships visible and manageable without leaving your own workspace:
Visibility
Teams can see whether their items are:
Blocking work in another workspace
Blocked by work from another workspace
This visibility helps teams coordinate delivery across larger organizations.
Permissions
Creating or modifying cross-workspace dependencies requires portfolio-level permissions:
Owner
Admin
Editor
Users without these permissions can still view inter-workspace dependencies.
How they display
Inside a workspace, cross-workspace dependencies appear like any other dependency.
At the portfolio level:
A numerical count indicates cross-workspace relationships
On the Portfolio Timeline, dependency lines can connect items across workspaces
This allows leadership teams to visualize cross-product dependencies on a single roadmap.
What comes next?
Now that you understand how dependencies work in Craft.io, you can start using them to improve planning and coordination across your roadmap.
Try the following:
Add dependencies to items that rely on other work to start
Use the Timeline view to visualize relationships across initiatives
Create a Table view that surfaces blocked items
Review dependencies regularly during roadmap and sprint planning sessions
When used consistently, dependencies transform your roadmap from a static plan into a collaborative planning tool that helps teams identify blockers early and deliver work more predictably.
Need more guidance? 🙋 Our LIVE support team (at the bottom right corner of your screen) replies to ANY question!




