diff --git a/packages/react/src/CounterLabel/CounterLabel.docs.json b/packages/react/src/CounterLabel/CounterLabel.docs.json
index 74f7e60a7fe..2a54c90331c 100644
--- a/packages/react/src/CounterLabel/CounterLabel.docs.json
+++ b/packages/react/src/CounterLabel/CounterLabel.docs.json
@@ -16,11 +16,18 @@
   ],
   "importPath": "@primer/react",
   "props": [
+    {
+      "name": "variant",
+      "type": "'primary' | 'secondary'",
+      "defaultValue": "",
+      "description": "Pass in 'primary' for a darker background and inverse text, or 'secondary' for a lighter background and primary text. Omitting the variant prop renders the default counter scheme"
+    },
     {
       "name": "scheme",
       "type": "'primary' | 'secondary'",
       "defaultValue": "",
-      "description": "Pass in 'primary' for a darker background and inverse text, or 'secondary' for a lighter background and primary text. Omitting the scheme prop renders the default counter scheme"
+      "description": "Use `variant` instead.",
+      "deprecated": true
     },
     {
       "name": "className",
diff --git a/packages/react/src/StateLabel/StateLabel.docs.json b/packages/react/src/StateLabel/StateLabel.docs.json
index 49d61f1b4ae..8dfacd7efab 100644
--- a/packages/react/src/StateLabel/StateLabel.docs.json
+++ b/packages/react/src/StateLabel/StateLabel.docs.json
@@ -64,10 +64,17 @@
   ],
   "importPath": "@primer/react",
   "props": [
+    {
+      "name": "size",
+      "type": "'small' | 'medium'",
+      "defaultValue": "'medium'"
+    },
     {
       "name": "variant",
       "type": "'small' | 'normal'",
-      "defaultValue": "'normal'"
+      "defaultValue": "'normal'",
+      "description": "Use `size` instead.",
+      "deprecated": true
     },
     {
       "name": "status",