diff --git a/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableResult.java b/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableResult.java
index 1b4b0e101..42044596b 100644
--- a/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableResult.java
+++ b/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableResult.java
@@ -61,6 +61,11 @@ public static Builder newBuilder() {
   @Nullable
   public abstract Schema getSchema();
 
+  /**
+   * Returns the total number of rows in the complete result set, which can be more than the number
+   * of rows in the first page of results. If no rows are returned, this value can still be greater
+   * than 0 if any rows were affected by the query, such as INSERT, UPDATE, or DELETE queries.
+   */
   public abstract long getTotalRows();
 
   public abstract Page<FieldValueList> getPageNoSchema();