diff --git a/src/network/access/qnetworkrequest.cpp b/src/network/access/qnetworkrequest.cpp
index 5905f8ab4d4..162bb28688c 100644
--- a/src/network/access/qnetworkrequest.cpp
+++ b/src/network/access/qnetworkrequest.cpp
@@ -731,6 +731,9 @@ QList<QByteArray> QNetworkRequest::rawHeaderList() const
     the same name, you should concatenate the two values, separating
     them with a comma (",") and set one single raw header.
 
+    \note Since Qt 6.8, the header field names are normalized
+    by converting them to lowercase.
+
     \sa KnownHeaders, setHeader(), hasRawHeader(), rawHeader()
 */
 void QNetworkRequest::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)