diff --git a/docs/users/configuration/settings.md b/docs/users/configuration/settings.md
index 10fbcdec456..9f76f4d77e5 100644
--- a/docs/users/configuration/settings.md
+++ b/docs/users/configuration/settings.md
@@ -109,7 +109,10 @@ Settings are organized into categories. Most settings should be placed within th
 | `ui.statusLine`                         | object           | Custom status line configuration. A shell command whose output is shown in the footer's left section. See [Status Line](../features/status-line).                                                                                                                                                                                                                                                                                                                                                                                                  | `undefined` |
 | `ui.hideWindowTitle`                    | boolean          | Hide the window title bar.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `false`     |
 | `ui.hideTips`                           | boolean          | Hide all tips (startup and post-response) in the UI. See [Contextual Tips](../features/tips).                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `false`     |
-| `ui.hideBanner`                         | boolean          | Hide the application banner.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | `false`     |
+| `ui.hideBanner`                         | boolean          | Hide the startup ASCII logo and info panel. Tips and chat input still render unless `ui.hideTips` is also set.                                                                                                                                                                                                                                                                                                                                                                                                                                     | `false`     |
+| `ui.customBannerTitle`                  | string           | Replace the default `>_ Qwen Code` title in the banner info panel. The `(vX.Y.Z)` version suffix is always appended; auth, model, and path lines are not affected. Sanitized; capped at 80 characters.                                                                                                                                                                                                                                                                                                                                             | `""`        |
+| `ui.customBannerSubtitle`               | string           | Optional subtitle line rendered between the banner title and the auth/model line, in place of the blank spacer row. Sanitized; capped at 160 characters. Empty (default) keeps the original blank spacer.                                                                                                                                                                                                                                                                                                                                          | `""`        |
+| `ui.customAsciiArt`                     | string \| object | Replace the QWEN ASCII logo in the banner. Accepts an inline string (used for both width tiers), `{ "path": "./brand.txt" }` (relative paths resolve against the owning settings file's directory; read once at startup with `O_NOFOLLOW` on POSIX, capped at 64 KB), or `{ "small": ..., "large": ... }` for width-aware selection. Sanitized; capped at 200 lines × 200 columns per tier.                                                                                                                                                        | `undefined` |
 | `ui.hideFooter`                         | boolean          | Hide the footer from the UI.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | `false`     |
 | `ui.showMemoryUsage`                    | boolean          | Display memory usage information in the UI.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | `false`     |
 | `ui.showLineNumbers`                    | boolean          | Show line numbers in code blocks in the CLI output.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `true`      |