diff --git a/sql/core/src/main/scala/org/apache/spark/sql/functions.scala b/sql/core/src/main/scala/org/apache/spark/sql/functions.scala
index 6bbdfa3ad189..f888eebe083a 100644
--- a/sql/core/src/main/scala/org/apache/spark/sql/functions.scala
+++ b/sql/core/src/main/scala/org/apache/spark/sql/functions.scala
@@ -2140,6 +2140,8 @@ object functions {
   /**
    * Calculates the hash code of given columns, and returns the result as an int column.
    *
+   * This is the same hash function as used internally by Spark for shuffle and bucketing.
+   *
    * @group misc_funcs
    * @since 2.0.0
    */