diff --git a/docs/upgrade.html b/docs/upgrade.html
index b45e25c400cda..1ff685c95cd80 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -85,6 +85,9 @@ <h5><a id="upgrade_400_notable" href="#upgrade_400_notable">Notable changes in 4
                         <li>The default properties files for KRaft mode are no longer stored in the separate <code>config/kraft</code> directory since Zookeeper has been removed. These files have been consolidated with other configuration files.
                             Now all configuration files are in <code>config</code> directory.
                         </li>
+                        <li>The valid format for <code>--bootstrap-server</code> only supports comma-separated value, such as <code>host1:port1,host2:port2,...</code>.
+                            Providing other formats, like space-separated bootstrap servers (e.g., <code>host1:port1 host2:port2 host3:port3</code>), will result in an exception, even though this was allowed in Apache Kafka versions prior to 4.0.
+                        </li>
                     </ul>
                 </li>
                 <li><b>Broker</b>