diff --git a/docs/plugin-ui-markup.md b/docs/plugin-ui-markup.md
index ee601902..ff591cec 100644
--- a/docs/plugin-ui-markup.md
+++ b/docs/plugin-ui-markup.md
@@ -108,9 +108,17 @@ vanishing from the built tree.
 | `toggle` | Lamp-style checkbox | `x y w h text checked onclick color` |
 | `slider` | Horizontal scalar | `x y w h value onchange` |
 | `field` | Single-line editable text | `x y w h text maxlength clearonsubmit onchange onsubmit color background` |
-| `menu` | Dropdown selector | `x y w h items selected onchange rows rowheight openupward` |
+| `menu` | Dropdown selector | `x y w h items selected onchange rows rowheight openupward style` |
 | `list` | Scrollable row list (+ Slice B icon column, + Campaign VT slice 1 multi-column) | `x y w h selected onchange rowheight` + either the single-column `items colors icons iconkind`, or one-to-many `<column>` children (see "Columns" below) — never both |
 
+`menu style` is `plain` (the default) or `retail`: retail's gold pushbutton
+art read as an out-of-place "big yellow button" next to a plugin's own dark
+list boxes (owner live-client report, 2026-09-07), so a plugin `<menu>` now
+draws the flat VTank/Decal `HudCombo` box (list-matching fill/border, a
+left-aligned value, and a small ▾) by default; `style="retail"` opts back
+into the gold face for a panel that genuinely wants it. Any other value
+throws `FormatException` at `Build`.
+
 Common to every element via `ApplyCommon`: `name`/`id` (a stable control
 name), `visible` (literal `true`/`false` or a bound `bool` property),
 `enabled` (same rule), and `tooltip` (a literal string or `{Binding}` shown