diff --git a/packages/web/docs/src/content/api-reference/cli.mdx b/packages/web/docs/src/content/api-reference/cli.mdx
index 354036f51..1f73260e2 100644
--- a/packages/web/docs/src/content/api-reference/cli.mdx
+++ b/packages/web/docs/src/content/api-reference/cli.mdx
@@ -166,14 +166,21 @@ Or, multiple files using a `glob` expression:
 hive schema:check "src/*.graphql"
 ```
 
-If you want to leverage from retaining approved breaking changes within the lifecyle of a pull/merge
-request or branch, you must provide the `--contextId` parameter. Using `--contextId` is optional
-when using GitHub repositories and actions with the `--github` flag.
+If you want to be able to leverage breaking change approvals, you must provide the `--contextId`
+parameter. Using `--contextId` is optional when using GitHub repositories and actions with the
+`--github` flag.
 
 ```bash
 hive schema:check --contextId "pr-123" "src/*.graphql"
 ```
 
+For distributed schemas (Federated or Stitching), you are able to view changes to subgraph URLs by
+providing the `--url` parameter.
+
+```bash
+hive schema:check "src/schema.graphql" --service users --url "https://users.graphql-hive.com/graphql"
+```
+
 Further reading:
 
 - [Publishing a schema to the Schema Registry](/docs/schema-registry#publish-a-schema)