diff --git a/signalfx-org-metrics/metrics.yaml b/signalfx-org-metrics/metrics.yaml
index 5514d04e..0128dac6 100644
--- a/signalfx-org-metrics/metrics.yaml
+++ b/signalfx-org-metrics/metrics.yaml
@@ -196,6 +196,8 @@ sf.org.apm.numSpansDroppedInvalidByToken:
 sf.org.apm.numSpansDroppedOversize:
   brief: The number of spans Splunk APM receives that are too large to process.
   description: |
+    This metric is deprecated. See `sf.org.apm.numSpansDroppedInvalid` with the `spanTooLarge` dimension.
+    
     The number of spans Splunk APM receives that are too large to process.
 
       * Dimension(s): `orgId`
@@ -207,6 +209,8 @@ sf.org.apm.numSpansDroppedOversizeByToken:
   brief: The number of spans Splunk APM receives that are too large to process
     for a specific access token.
   description: |
+    This metric is deprecated. See `sf.org.apm.numSpansDroppedInvalid` with the `spanTooLarge` dimension.
+    
     The number of spans Splunk APM receives that are too large to process
     for a specific access token.
 
@@ -2157,8 +2161,6 @@ sf.org.rum.numAddSpansCallsByToken:
 sf.org.rum.numSpansDroppedInvalid:
   brief: Number of spans dropped because they were invalid. 
   description: |
-    This metric is deprecated. See `sf.org.apm.numSpansDroppedInvalid` with the `spanTooLarge` dimension.
-    
     Number of spans dropped because they were invalid. Some of the reasons that spans are invalid are: spans are too large, missing required tags and invalid Trace IDs. Look through the reason column in the data table to see details for specific spans. 
 
      * Dimension: `orgId`, `reason`
@@ -2170,8 +2172,6 @@ sf.org.rum.numSpansDroppedInvalidByToken:
   brief: The number of invalid spans Splunk RUM receives for a specific access
     token.
   description: | 
-    This metric is deprecated. See `sf.org.apm.numSpansDroppedInvalid` with the `spanTooLarge` dimension.
-    
     The number of invalid spans Splunk RUM receives for a specific
     access token. Some of the reasons that spans are invalid are: spans are too large, missing required tags and invalid Trace IDs. Look through the reason column in the data table to see details for specific spans.