diff --git a/docs/features/software-catalog/descriptor-format.md b/docs/features/software-catalog/descriptor-format.md
index 6e3ac37657..1aab1268cd 100644
--- a/docs/features/software-catalog/descriptor-format.md
+++ b/docs/features/software-catalog/descriptor-format.md
@@ -87,9 +87,9 @@ metadata:
   tags:
     - java
   links:
-    url: https://admin.example-org.com
-    title: Admin Dashboard
-    icon: dashboard
+    - url: https://admin.example-org.com
+      title: Admin Dashboard
+      icon: dashboard
 spec:
   type: website
   lifecycle: production
diff --git a/packages/catalog-model/examples/acme/org.yaml b/packages/catalog-model/examples/acme/org.yaml
index f0a5003f7c..9a0d690b57 100644
--- a/packages/catalog-model/examples/acme/org.yaml
+++ b/packages/catalog-model/examples/acme/org.yaml
@@ -5,9 +5,9 @@ metadata:
   description: The acme-corp organization
   links:
     - url: http://www.acme.com/
-      name: Website
+      title: Website
     - url: https://meta.wikimedia.org/wiki/
-      name: Intranet
+      title: Intranet
 spec:
   type: organization
   profile:
diff --git a/packages/catalog-model/examples/apis/petstore-api.yaml b/packages/catalog-model/examples/apis/petstore-api.yaml
index 4c18b16a16..5b6878f7d3 100644
--- a/packages/catalog-model/examples/apis/petstore-api.yaml
+++ b/packages/catalog-model/examples/apis/petstore-api.yaml
@@ -12,7 +12,7 @@ metadata:
       icon: github
     - url: https://github.com/OAI/OpenAPI-Specification/blob/master/examples/v3.0/petstore.yaml
       title: API Spec
-      code: code
+      icon: code
 spec:
   type: openapi
   lifecycle: experimental