diff --git a/doc/api/group_badges.md b/doc/api/group_badges.md
index ede7591c6d1176989e873d1f9f0667652ddda063..0d5faae7c14298e581c5f1fa8d7d8f653c81a879 100644
--- a/doc/api/group_badges.md
+++ b/doc/api/group_badges.md
@@ -10,7 +10,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
 
 ## Placeholder tokens
 
-Badges support placeholders that are replaced in real time in both the link and image URL. The allowed placeholders are:
+[Badges](../user/project/badges.md) support placeholders that are replaced in real time in both the link and image URL. The allowed placeholders are:
 
 <!-- vale gitlab.Spelling = NO -->
 
diff --git a/doc/api/project_badges.md b/doc/api/project_badges.md
index 3dad40a3f96859ea763e691a1a15ba26d04bc877..a8940a7875c36deae3f449ec21e2074d36a5348a 100644
--- a/doc/api/project_badges.md
+++ b/doc/api/project_badges.md
@@ -8,7 +8,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w
 
 ## Placeholder tokens
 
-Badges support placeholders that are replaced in real-time in both the link and image URL. The allowed placeholders are:
+[Badges](../user/project/badges.md) support placeholders that are replaced in real-time in both the link and image URL. The allowed placeholders are:
 
 <!-- vale gitlab.Spelling = NO -->