Skip to main content

A deep dive into Craft.io dependencies

Learn how to manage dependencies in the Workspace and Portfolio

J
Written by Jenny Goldberger
Updated yesterday

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.

  1. Open any item

  2. Navigate to the Dependencies tab

  3. 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.

  1. Select + or Column to add a new column into view

  2. 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:

  1. Open View Settings

  2. 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!

Did this answer your question?