diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryImpl.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryImpl.java
index a5e91886d030..a7c1c6f42403 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryImpl.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryImpl.java
@@ -1657,6 +1657,12 @@ public Routine apply(com.google.api.services.bigquery.model.Routine routinePb) {
     }
   }
 
+  /**
+   * Inserts the specified rows into a table using the BigQuery insertAll API.
+   * Note: To prevent duplicate rows, this method does not perform automatic retries unless
+   * insert IDs are provided. Transient service errors (such as UNAVAILABLE) may be thrown and
+   * should be handled by the caller.
+   */
   @Override
   public InsertAllResponse insertAll(InsertAllRequest request) {
     final TableId tableId =