diff --git a/docs/features/software-catalog/descriptor-format.md b/docs/features/software-catalog/descriptor-format.md
index 57473ce4c7..ec4e13c1d4 100644
--- a/docs/features/software-catalog/descriptor-format.md
+++ b/docs/features/software-catalog/descriptor-format.md
@@ -1266,6 +1266,10 @@ shape, this kind has the following structure.
 
 Exactly equal to `backstage.io/v1alpha1` and `Location`, respectively.
 
+### `spec` [required]
+
+The `spec` field is required. The minimal spec should be an empty object.
+
 ### `spec.type` [optional]
 
 The single location type, that's common to the targets specified in the spec. If