diff --git a/docs/features/images/metrics-share-url-1.png b/docs/features/images/metrics-share-url-1.png
new file mode 100644
index 00000000..539e12a3
Binary files /dev/null and b/docs/features/images/metrics-share-url-1.png differ
diff --git a/docs/features/metrics.md b/docs/features/metrics.md
index 8438c748..591b7367 100644
--- a/docs/features/metrics.md
+++ b/docs/features/metrics.md
@@ -52,6 +52,12 @@ Metrics in OpenObserve enable you to track key performance indicators, monitor s
 
 ![Metrics Alerting](../images/features/metrics-alerts.png)
 
+- **Share Metrics Views**: Share an exact metrics view with your team by copying a URL from the **Share** button in the metrics toolbar. The URL encodes your current panel configuration — chart type, queries (PromQL or SQL), stream selection, time range, and refresh interval — so recipients see the same chart and data. Opening a shared link auto-restores the view and runs the query immediately.
+
+![Share button in metrics page toolbar](images/metrics-share-url-1.png)
+
+The share URL carries the full panel state as a versioned base64 blob in the `metrics_data` query parameter. The metrics page also accepts lightweight deep-link overrides (`chart_type`, `query_type`, `stream_name`, `query`) for programmatic linking from alerts, dashboards, and other pages.
+
 ### Storage & Performance
 
 - **Optimized Compression**: Advanced compression algorithms reduce storage costs.