diff --git a/docs/generated/core_configuration.html b/docs/generated/core_configuration.html
index 434ad801394a..97aad929751b 100644
--- a/docs/generated/core_configuration.html
+++ b/docs/generated/core_configuration.html
@@ -1612,8 +1612,8 @@
sort-compaction.range-strategy |
SIZE |
Enum |
- The range strategy of sort compaction, the default value is quantity.
-If the data size allocated for the sorting task is uneven,which may lead to performance bottlenecks, the config can be set to size.
Possible values: |
+ The range strategy of sort compaction, the default value is size.
+The size strategy ranges by the data size allocated to each sorting task, which avoids the performance bottlenecks caused by uneven data size. The config can be set to quantity to range by the number of rows instead.
Possible values: |
sort-engine |
diff --git a/paimon-api/src/main/java/org/apache/paimon/CoreOptions.java b/paimon-api/src/main/java/org/apache/paimon/CoreOptions.java
index bc1a2102bc78..3c644d953b56 100644
--- a/paimon-api/src/main/java/org/apache/paimon/CoreOptions.java
+++ b/paimon-api/src/main/java/org/apache/paimon/CoreOptions.java
@@ -2166,9 +2166,10 @@ public String toString() {
.enumType(RangeStrategy.class)
.defaultValue(RangeStrategy.SIZE)
.withDescription(
- "The range strategy of sort compaction, the default value is quantity.\n"
- + "If the data size allocated for the sorting task is uneven,which may lead to performance bottlenecks, "
- + "the config can be set to size.");
+ "The range strategy of sort compaction, the default value is size.\n"
+ + "The size strategy ranges by the data size allocated to each sorting task, which avoids "
+ + "the performance bottlenecks caused by uneven data size. "
+ + "The config can be set to quantity to range by the number of rows instead.");
public static final ConfigOption SORT_COMPACTION_SAMPLE_MAGNIFICATION =
key("sort-compaction.local-sample.magnification")