diff --git a/sentry/src/main/java/io/sentry/metrics/MetricsUnit.java b/sentry/src/main/java/io/sentry/metrics/MetricsUnit.java
index 4665cdf33a..6b060b7827 100644
--- a/sentry/src/main/java/io/sentry/metrics/MetricsUnit.java
+++ b/sentry/src/main/java/io/sentry/metrics/MetricsUnit.java
@@ -3,7 +3,13 @@
 /**
  * String constants for metric units.
  *
- * <p>These constants represent the API names of measurement units that can be used with metrics.
+ * <p>These constants are for the Metrics product and the {@link IMetricsApi} exposed through {@link
+ * io.sentry.Sentry#metrics()} and {@link io.sentry.IScopes#metrics()}. {@link
+ * io.sentry.MeasurementUnit} is instead used by transaction and span measurement APIs, including
+ * mobile vitals.
+ *
+ * <p>Metrics APIs accept strings so older SDK versions can use units introduced after their
+ * release.
  */
 public final class MetricsUnit {