diff --git a/docs/src/pages/components/NumberInput.svx b/docs/src/pages/components/NumberInput.svx
index ea017fe3..3cbba1df 100644
--- a/docs/src/pages/components/NumberInput.svx
+++ b/docs/src/pages/components/NumberInput.svx
@@ -9,11 +9,15 @@ components: ["NumberInput", "NumberInputSkeleton"]
### Default
-
+This component requires a numerical value for `value`.
+
+See [#no-value](#no-value) to allow for an empty value.
+
+
### With helper text
-
+
### Minimum and maximum values
@@ -29,39 +33,39 @@ Set `value` to `null` to denote "no value."
### Hidden label
-
+
### Hidden steppers
-
+
### Light variant
-
+
### Read-only variant
-
+
### Extra-large size
-
+
### Small size
-
+
### Invalid state
-
+
### Warning state
-
+
### Disabled state
-
+
### Skeleton