1 files changed, 47 insertions, 0 deletions
diff --git a/doc/user/tasks.md b/doc/user/tasks.md
index f4fec01d42b..347aedd6e74 100644
--- a/doc/user/tasks.md
+++ b/doc/user/tasks.md
@@ -443,3 +443,50 @@ The description and threads are on the left, and attributes, such as labels
 or assignees, on the right.
 
 ![Task two column view](img/task_two_column_view_v16_2.png)
+
+## Linked items in Tasks
+
+> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/416558) in GitLab 16.5 [with a flag](../administration/feature_flags.md) named `linked_work_items`. Disabled by default.
+
+FLAG:
+On self-managed GitLab, by default this feature is not available. To make it available, an administrator can [enable the feature flag](../administration/feature_flags.md) named `linked_work_items`.
+On GitLab.com, this feature is not available.
+This feature is not ready for production use.
+
+Linked items are a bi-directional relationship and appear in a block below
+the emoji reactions section. You can link an objective, key result, or a task in the same project with each other.
+
+The relationship only shows up in the UI if the user can see both items.
+
+### Add a linked item
+
+Prerequisite:
+
+- You must have at least the Guest role for the project.
+
+To link an item to a task:
+
+1. In the **Linked items** section of a task,
+   select the **Add** button.
+1. Select the relationship between the two items. Either:
+   - **relates to**
+   - **blocks**
+   - **is blocked by**
+1. Enter the search text of the item.
+1. When you have added all the items to be linked, select **Add** below the search box.
+
+When you have finished adding all linked items, you can see
+them categorized so their relationships can be better understood visually.
+
+![Linked items block](img/linked_items_list_v16_5.png)
+
+### Remove a linked item
+
+Prerequisite:
+
+- You must have at least the Guest role for the project.
+
+In the **Linked items** section of a task,
+next to each item, select the vertical ellipsis (**{ellipsis_v}**) and then select **Remove**.
+
+Due to the bi-directional relationship, the relationship no longer appears in either item.