diff --git a/website/docs/table-design/data-distribution/partitioning.md b/website/docs/table-design/data-distribution/partitioning.md
index ffeef84f6e..30460933d0 100644
--- a/website/docs/table-design/data-distribution/partitioning.md
+++ b/website/docs/table-design/data-distribution/partitioning.md
@@ -30,7 +30,7 @@ For example, in an `Order` primary key table, the partition key can be defined a
 - The partition key must be a Fluss native data type and cannot be contained in a map or list.
 - For auto partition table, the partition keys can be one or more. If the table has only one partition key, it supports automatic creation and automatic expiration of partitions. Otherwise, only automatic expiration is allowed.
 - If the table is a primary key table, the partition key must be a subset of the primary key.
-- Auto-partitioning rules can only be configured at the time of creating the partitioned table; modifying the auto-partitioning rules after table creation is not supported.
+- Auto-partitioning rules can only be configured at the time of creating the partitioned table, except `table.auto-partition.num-retention`, which can be modified by `ALTER TABLE ... SET` after table creation.
 
 ## Auto Partitioning
 ### Example
@@ -61,7 +61,7 @@ In this case, when automatic partitioning occurs (Fluss will periodically operat
 | table.auto-partition.key           | String  | no       | (none)               | This configuration defines the time-based partition key to be used for auto-partitioning when a table is partitioned with multiple keys. Auto-partitioning utilizes a time-based partition key to handle partitions automatically, including creating new ones and removing outdated ones, by comparing the time value of the partition with the current system time. In the case of a table using multiple partition keys (such as a composite partitioning strategy), this feature determines which key should serve as the primary time dimension for making auto-partitioning decisions. And If the table has only one partition key, this config is not necessary. Otherwise, it must be specified.      |
 | table.auto-partition.time-unit     | ENUM    | no       | DAY                  | The time granularity for auto created partitions. The default value is 'DAY'. Valid values are 'HOUR', 'DAY', 'MONTH', 'QUARTER', 'YEAR'. If the value is 'HOUR', the partition format for auto created is yyyyMMddHH. If the value is 'DAY', the partition format for auto created is yyyyMMdd. If the value is 'MONTH', the partition format for auto created is yyyyMM. If the value is 'QUARTER', the partition format for auto created is yyyyQ. If the value is 'YEAR', the partition format for auto created is yyyy.                                                                                                                                                                                  |
 | table.auto-partition.num-precreate | Integer | no       | 2                    | The number of partitions to pre-create for auto created partitions in each check for auto partition. For example, if the current check time is 2024-11-11 and the value is configured as 3, then partitions 20241111, 20241112, 20241113 will be pre-created. If any one partition exists, it'll skip creating the partition. The default value is 2, which means 2 partitions will be pre-created. If the 'table.auto-partition.time-unit' is 'DAY'(default), one precreated partition is for today and another one is for tomorrow. For a partition table with multiple partition keys, pre-create is unsupported and will be set to 0 automatically when creating table if it is not explicitly specified. |
-| table.auto-partition.num-retention | Integer | no       | 7                    | The number of history partitions to retain for auto created partitions in each check for auto partition. For example, if the current check time is 2024-11-11, time-unit is DAY, and the value is configured as 3, then the history partitions 20241108, 20241109, 20241110 will be retained. The partitions earlier than 20241108 will be deleted. The default value is 7.                                                                                                                                                                                                                                                                                                                                   |
+| table.auto-partition.num-retention | Integer | no       | 7                    | The number of history partitions to retain for auto created partitions in each check for auto partition. For example, if the current check time is 2024-11-11, time-unit is DAY, and the value is configured as 3, then the history partitions 20241108, 20241109, 20241110 will be retained. The partitions earlier than 20241108 will be deleted. The default value is 7. This option can be modified after table creation by `ALTER TABLE ... SET`.                                                                                                                                                                                                                                       |
 | table.auto-partition.time-zone     | String  | no       | the system time zone | The time zone for auto partitions, which is by default the same as the system time zone.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 
 ### Partition Generation Rules