diff --git a/src/java.base/share/classes/java/lang/String.java b/src/java.base/share/classes/java/lang/String.java
index 0541e706e7d..ad1e2d3873b 100644
--- a/src/java.base/share/classes/java/lang/String.java
+++ b/src/java.base/share/classes/java/lang/String.java
@@ -2106,6 +2106,9 @@ public final class String
     /**
      * {@return the length in bytes of the given String encoded with the given {@link Charset}}
      *
+     * <p>The returned length accounts for the replacement of malformed-input and unmappable-character
+     * sequences with the charset's default replacement byte array.
+     *
      * <p>The result will be the same value as {@link #getBytes(Charset) getBytes(cs).length}.
      *
      * @apiNote This method provides equivalent or better performance than {@link #getBytes(Charset)