diff --git a/docs/features/software-catalog/descriptor-format.md b/docs/features/software-catalog/descriptor-format.md
index 1134fbb61a..469085a4c5 100644
--- a/docs/features/software-catalog/descriptor-format.md
+++ b/docs/features/software-catalog/descriptor-format.md
@@ -86,6 +86,10 @@ metadata:
     circleci.com/project-slug: github/example-org/artist-website
   tags:
     - java
+  links:
+    url: https://admin.example-org.com
+    title: Admin Dashboard
+    icon: dashboard
 spec:
   type: website
   lifecycle: production