diff --git a/doc/user/permissions.md b/doc/user/permissions.md
index a57ae5c775290e708b20e382f1134345b1bf9545..7689a8c21e48b01decd5f3225d6c5d4cc5006369 100644
--- a/doc/user/permissions.md
+++ b/doc/user/permissions.md
@@ -25,6 +25,7 @@ The following table depicts the various user permission levels in a project.
 | Create confidential issue             | ✓       | ✓          | ✓           | ✓        | ✓      |
 | View confidential issues              | (✓) [^1] | ✓          | ✓           | ✓        | ✓      |
 | Leave comments                        | ✓       | ✓          | ✓           | ✓        | ✓      |
+| See related issues                    | ✓       | ✓          | ✓           | ✓        | ✓      |
 | See a list of jobs                    | ✓ [^2]  | ✓          | ✓           | ✓        | ✓      |
 | See a job   log                       | ✓ [^2]  | ✓          | ✓           | ✓        | ✓      |
 | Download and browse job artifacts     | ✓ [^2]  | ✓          | ✓           | ✓        | ✓      |
@@ -38,6 +39,7 @@ The following table depicts the various user permission levels in a project.
 | See a container registry              |         | ✓          | ✓           | ✓        | ✓      |
 | See environments                      |         | ✓          | ✓           | ✓        | ✓      |
 | Create new environments               |         |            | ✓           | ✓        | ✓      |
+| Manage related issues                 |         | ✓          | ✓           | ✓        | ✓      |
 | Use environment terminals             |         |            |             | ✓        | ✓      |
 | Stop environments                     |         |            | ✓           | ✓        | ✓      |
 | See a list of merge requests          |         | ✓          | ✓           | ✓        | ✓      |
diff --git a/doc/user/project/issues/related_issues.md b/doc/user/project/issues/related_issues.md
index 851112dcaafbddf626c646640b306ae7fd8a3034..40ac756d27ae24b3a89ff44df37c5f36c766924f 100644
--- a/doc/user/project/issues/related_issues.md
+++ b/doc/user/project/issues/related_issues.md
@@ -6,8 +6,8 @@ Related issues are a bi-directional relationship between any two issues
 and appear in a block below the issue description. Issues can be across groups
 and projects.
 
-The relationship only shows up in the UI if the user has write [permissions]
-to see both issues (`> Guest`).
+The relationship only shows up in the UI if the user has read [permissions]
+to see both issues.
 
 ## Adding a related issue
 
@@ -28,6 +28,10 @@ either issue.
 
 ![Removing a related issue](img/related_issues_remove.png)
 
+As an addition, you are also able to manage related issues through [our API].
+
 [ee]: https://about.gitlab.com/gitlab-ee/
 [ee-1797]: https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1797
 [permissions]: ../../permissions.md
+[EE]: ../../permissions.md
+[Our API]: ../../../api/issue_links.md