microsoft · liunan-ms · Jul 13, 2026
diff --git a/docs/user/reference/cli/azldev_component.md b/docs/user/reference/cli/azldev_component.md
diff --git a/docs/user/reference/cli/azldev_component_metadata.md b/docs/user/reference/cli/azldev_component_metadata.md
diff --git a/docs/user/reference/config/overlays.md b/docs/user/reference/config/overlays.md
@@ -248,6 +248,10 @@ section = "%changelog"
 lines = ["- Fix CVE-2024-1234"]
 ```
 
+### Inspecting overlay metadata
+
+Use `azldev component metadata` to list documentation metadata for one or more components. By default it lists metadata from both sources — component overlays and the component groups each component belongs to — tagging each row with its `source`, and shows only entries that carry a `[metadata]` block. Pass `--overlays` or `--groups` to restrict to one source. The command is read-only and supports `--category` and `--upstream-status` filters; output is available as a table (default) or JSON (`-O json`).
+
 ## Examples
 
 ### Adding a Build Dependency

diff --git a/internal/app/azldev/cmds/component/component.go b/internal/app/azldev/cmds/component/component.go
@@ -33,4 +33,5 @@ components defined in the project configuration.`,
 	queryOnAppInit(app, cmd)
 	renderOnAppInit(app, cmd)
 	updateOnAppInit(app, cmd)
+	metadataOnAppInit(app, cmd)
 }