diff --git a/docs/features/software-catalog/descriptor-format.md b/docs/features/software-catalog/descriptor-format.md
index fb17f4a434..f39454a797 100644
--- a/docs/features/software-catalog/descriptor-format.md
+++ b/docs/features/software-catalog/descriptor-format.md
@@ -231,6 +231,14 @@ follows.
 
 Example: `visits-tracking-service`, `CircleciBuildsDumpV2_avro_gcs`
 
+### `title` [optional]
+
+The title of the entity. This is a friendly title to be used in the Backstage
+interface. This is an optional property, if it doesn't exist the `name` property
+will be used.
+
+Only available for Templates and Docs.
+
 ### `namespace` [optional]
 
 The ID of a namespace that the entity belongs to. This is a string that follows