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..2ad09c33d7cb 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
@@ -1659,6 +1659,10 @@ public Routine apply(com.google.api.services.bigquery.model.Routine routinePb) {
 
   @Override
   public InsertAllResponse insertAll(InsertAllRequest request) {
+    // This API 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.
     final TableId tableId =
         request
             .getTable()