diff --git a/docs/SETTINGS_JSON.md b/docs/SETTINGS_JSON.md
index 148b7017..aa35231b 100644
--- a/docs/SETTINGS_JSON.md
+++ b/docs/SETTINGS_JSON.md
@@ -70,6 +70,8 @@ fields marked safe, but Ceiling may overwrite the file when the app exits.
 | `taskbar_widget_open_on_hover` | boolean | `true` | Open the taskbar glance panel after pointer dwell. Safe to edit. |
 | `float_bar_density` | string | `"standard"` | `"compact"`, `"standard"`, or `"detailed"`. Safe to edit. |
 | `float_bar_information_mode` | string | `"exact"` | `"exact"` or `"calm"`. Safe to edit. |
+| `float_bar_selection_mode` | string | `"pinned"` | `"pinned"` (the configured list), `"active"` (the focused supported app), or `"activePlusCritical"` (active plus any provider in the display set at or above the warning threshold). The display set is `float_bar_provider_ids` when that is non-empty, otherwise every enabled provider. Matching is exact and untrimmed, so `"Active"` or `" active "` fall back to `"pinned"`, as does any other unrecognized string. The active provider is sticky: an unrecognized window keeps it, but focusing an app mapped to a provider that is disabled or failing replaces it, and the bar falls back to the display set until a usable provider is focused. The display set is also what you see before anything has matched. Safe to edit. |
+| `float_bar_foreground_detection` | boolean | `true` | When `false`, `"active"` / `"activePlusCritical"` keep the pinned list and do not read the focused window. Safe to edit. |
 | `float_bar_contrast` | string or null | `"auto"` | `"auto"`, `"light-text"`, or `"dark-text"`; an invalid string normalizes to `"auto"`. `null` is accepted and deserializes to `None`, which resolves through the legacy `float_bar_dark_text` flag instead. Safe to edit. |
 | `float_bar_click_through` | boolean | `false` | Make the floating bar fully click-through. Safe to edit. |
 | `float_bar_provider_ids` | array of strings | `[]` | Empty means all enabled providers. Safe to edit. |