diff --git a/packages/react/src/Button/Button.docs.json b/packages/react/src/Button/Button.docs.json
index 4aaf5d5b552..7d9c34ae799 100644
--- a/packages/react/src/Button/Button.docs.json
+++ b/packages/react/src/Button/Button.docs.json
@@ -95,6 +95,11 @@
       "type": "React.ElementType",
       "defaultValue": "'button'"
     },
+    {
+      "name": "href",
+      "type": "string",
+      "description": "**May only be used when `as` is set to 'a'**.\n The URL the button links to. If `as` is set to 'a', this prop is required."
+    },
     {
       "name": "block",
       "type": "boolean",
@@ -190,4 +195,4 @@
     "element": "button",
     "url": "https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attributes"
   }
-}
\ No newline at end of file
+}
diff --git a/packages/react/src/Button/IconButton.docs.json b/packages/react/src/Button/IconButton.docs.json
index 912896b4b42..0fa6b65384d 100644
--- a/packages/react/src/Button/IconButton.docs.json
+++ b/packages/react/src/Button/IconButton.docs.json
@@ -62,6 +62,16 @@
       "required": true,
       "description": "This will be the Button description."
     },
+    {
+      "name": "as",
+      "type": "React.ElementType",
+      "defaultValue": "'button'"
+    },
+    {
+      "name": "href",
+      "type": "string",
+      "description": "**May only be used when `as` is set to 'a'**.\n The URL the button links to. If `as` is set to 'a', this prop is required."
+    },
     {
       "name": "variant",
       "type": "'default' | 'primary' | 'danger' | 'invisible' | 'link'",
@@ -124,4 +134,4 @@
     }
   ],
   "subcomponents": []
-}
\ No newline at end of file
+}