Task Relations

Link tasks together with relations like subtask, blocking, related, and more.

Task relations let you create links between tasks to express dependencies, hierarchies, or other connections. You can add relations from the right sidebar of the task detail view.

Adding a relation#

  1. Open a task and scroll to the Relations section in the right sidebar.
  2. Click Add a relation.
  3. Search for the task you want to link to.
  4. Choose the relation type from the dropdown.
Relation type dropdown with available options

The relation is applied immediately. The linked task will show the opposite relation automatically. For example, if you mark “Order new furniture” as blocking “Set up meeting rooms”, “Set up meeting rooms” will show that it is blocked by “Order new furniture”.

Removing a relation#

To remove an existing relation, open the task detail view and click the remove button next to the relation you want to delete.

Default relation type#

When adding a relation, Vikunja uses a default relation type. You can change this default in Settings → General → Default task relation type.

Available relation types#

TypeDescriptionOpposite
SubtaskThe task is a subtask of the other task.Parent task
Parent taskThe task is a parent task of the other task.Subtask
RelatedBoth tasks are related to each other. The connection is not further specified.Related
Duplicate ofThe task is a duplicate of the other task.Duplicates
DuplicatesThe task duplicates the other task.Duplicate of
BlockingThe task is blocking the other task.Blocked by
Blocked byThe task is blocked by the other task.Blocking
PrecedesThe task comes before the other task.Follows
FollowsThe task comes after the other task.Precedes
Copied fromThe task was copied from the other task.Copied to
Copied toThe task was copied to the other task.Copied from

The Related type is symmetric and reads the same from both sides. All other types have a directional opposite that is set automatically on the linked task.

You can also create subtask relations using indented Quick Add Magic input.