diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/FlushPolicy.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/FlushPolicy.java
index 0fa7f2319f..bff10fe1d8 100644
--- a/google-cloud-storage/src/main/java/com/google/cloud/storage/FlushPolicy.java
+++ b/google-cloud-storage/src/main/java/com/google/cloud/storage/FlushPolicy.java
@@ -108,6 +108,9 @@ abstract BufferedWritableByteChannel createBufferedChannel(
    *
    * <p>Instances of this class are immutable and thread safe.
    *
+   * <p>Instead of this, strategy use {@link FlushPolicy#minFlushSize()}{@code .}{@link
+   * MinFlushSizeFlushPolicy#withMaxPendingBytes(long) withMaxPendingBytes(long)}
+   *
    * @since 2.51.0 This new api is in preview and is subject to breaking changes.
    */
   @Immutable