diff --git a/docs/product/metrics/index.mdx b/docs/product/metrics/index.mdx
index c7c64b9a79e58..f163f23fc79a9 100644
--- a/docs/product/metrics/index.mdx
+++ b/docs/product/metrics/index.mdx
@@ -6,7 +6,9 @@ description: "Metrics help you track and visualize the data points you care abou
-Sentry metrics are numerical values that allow you to pinpoint and solve issues impacting user experience and app performance by measuring the data points that are important to you and your application. You can track things like latency, processing time, event size, user signups, and conversion rates, and see how they correlate back to tracing data. This gives you a comprehensive understanding of the health of your systems and helps solve issues faster.
+
+
+Sentry metrics are numerical values that allow you to pinpoint and solve issues impacting user experience and app performance by measuring the data points that are important to you and your application. You can track things like latency, processing time, event size, user signups and conversion rates, and see how they correlate back to tracing data. This gives you a comprehensive understanding of the health of your systems and helps solve issues faster.
![Metrics UI](./img/Index.png)
diff --git a/includes/metrics-api-change.mdx b/includes/metrics-api-change.mdx
new file mode 100644
index 0000000000000..c2df9589fd603
--- /dev/null
+++ b/includes/metrics-api-change.mdx
@@ -0,0 +1,3 @@
+
+We'lll be updating our API to ensure that metrics are explicitly connected to spans. This change will improve debugging capabilities by ensuring that metrics are always contextually linked with all your Sentry data through traces. You'll eventually need to migrate to the new APIs once released. [Learn more](https://sentry.zendesk.com/hc/en-us/articles/26369339769883-Upcoming-API-Changes-to-Metrics).
+