diff --git a/docs/OPTIONS.md b/docs/OPTIONS.md
index 4507431..6005e09 100644
--- a/docs/OPTIONS.md
+++ b/docs/OPTIONS.md
@@ -177,6 +177,10 @@ Without prime config, supergfxd still switches modes but render-offload via `nvi
 
 `enum ["top", "bottom"]`, default `"top"`. Waybar panel position.
 
+### `nomarchy.hyprland.gaps_in` / `nomarchy.hyprland.gaps_out` / `nomarchy.hyprland.border_size`
+
+`int`, defaults `5` / `10` / `2`. Hyprland window inner gaps, outer gaps, and active-border width (px). Map to Hyprland's `general.{gaps_in,gaps_out,border_size}` in `features/desktop/hyprland/default.nix`. Defaults come from `lib/state-schema.nix` and are read from `~/.config/nomarchy/state.json`, so they can be retuned without a rebuild; set them here to make a choice permanent.
+
 ### `nomarchy.formFactor`
 
 `enum [ "laptop" "desktop" ]`, default `"laptop"`. Mirror of `nomarchy.system.formFactor`. Filters laptop-only widgets out of waybar (battery) when set to `"desktop"`. The installer writes both system and home values together.