diff --git a/docs/developer/cli-arguments.md b/docs/developer/cli-arguments.md
index 887326b99..d108a451f 100644
--- a/docs/developer/cli-arguments.md
+++ b/docs/developer/cli-arguments.md
@@ -24,6 +24,7 @@ spec:
 <!-- markdownlint-disable blanks-around-fences -->
 <!-- markdownlint-disable link-image-reference-definitions -->
 [embedmd]:# (../../help.txt)
+
 ```txt
 $ kube-state-metrics -h
 kube-state-metrics is a simple service that listens to the Kubernetes API server and generates metrics about the state of the objects.
@@ -90,5 +91,101 @@ Flags:
 
 Use "kube-state-metrics [command] --help" for more information about a command.
 ```
-<!-- markdownlint-enable link-image-reference-definitions -->
-<!-- markdownlint-enable blanks-around-fences -->
+
+## Examples
+
+```bash
+# Bool flag
+kube-state-metrics --enable-gzip-encoding
+```
+
+```bash
+# Int flag
+kube-state-metrics --port=9090
+```
+
+```bash
+# String flag
+kube-state-metrics --apiserver="https://my-apiserver:6443"
+```
+
+```bash
+# Duration flags
+kube-state-metrics --server-idle-timeout=2m --server-write-timeout=30s
+```
+
+```bash
+# List flags (formatted as a single string)
+kube-state-metrics \
+  --metric-allowlist="kube_pod_info,kube_node_*" \
+  --metric-denylist="kube_pod_labels_total,kube_service_info" \
+  --metric-annotations-allowlist="namespaces=[kubernetes.io/team],pods=[owner]" \
+  --metric-labels-allowlist="namespaces=[kubernetes.io/team],pods=[owner]" \
+  --namespaces-denylist="default,kube-system"
+```
+
+### Config-file support
+
+You can provide a YAML config file using the `--config` flag instead of (or in addition to) command-line flags. Any flags passed on the command line will override values in the config file.
+
+Example `config.yaml`:
+
+```yaml
+port: 9090
+serverIdleTimeout: "2m"
+metricAllowlist:
+  - kube_pod_info
+  - kube_node_*
+```
+
+Run with config file:
+
+```bash
+kube-state-metrics --config=config.yaml --port=8085
+```
+
+### Mutual-exclusion of allowlists and denylists
+
+For metrics, annotations, and labels, allowlists and denylists cannot be used together. If both are specified, the allowlist takes precedence and the denylist is ignored.
+
+### Kubernetes Deployment example
+
+You can embed any of the flags in a Deployment manifest under `args:`:
+
+```yaml
+spec:
+  template:
+    spec:
+      containers:
+        - name: kube-state-metrics
+          args:
+            - "--metric-allowlist=kube_pod_info,kube_node_*"
+            - "--server-idle-timeout=2m"
+```
+
+### Experimental flags
+
+The following flags are experimental and subject to change:
+
+* `--auto-gomemlimit`, `--auto-gomemlimit-ratio`
+* `--auth-filter`
+* `--shard`, `--total-shards`
+* `--track-unscheduled-pods`
+
+### Custom Resource State metrics
+
+You can enable custom resource state metrics using:
+
+```bash
+kube-state-metrics --custom-resource-state-config-file=crs-config.yaml
+```
+
+Example `crs-config.yaml`:
+
+```yaml
+resources:
+  pods:
+    state:
+      - Pending
+      - Running
+```