diff --git a/docs/content.zh/docs/ops/upgrading.md b/docs/content.zh/docs/ops/upgrading.md
index b5c9340f81ee6..c0740b5abd9a3 100644
--- a/docs/content.zh/docs/ops/upgrading.md
+++ b/docs/content.zh/docs/ops/upgrading.md
@@ -245,6 +245,9 @@ $ bin/flink run -s :savepointPath [:runArgs]
 
  Savepoint 在 Flink 版本之间是兼容的，如下表所示：
 
+***注意***：此处的“兼容”仅指 Savepoint 内部数据格式的兼容性，并不包含 SQL 算子或其他上层改动的兼容性。
+在实践中，只要 Flink SQL 语义没有发生变化，这种状态格式的兼容性通常也能保证作业级别的兼容性。
+
 <table class="table table-bordered" style="font-size:8pt">
   <thead>
     <tr>
diff --git a/docs/content/docs/ops/upgrading.md b/docs/content/docs/ops/upgrading.md
index 81251211c027b..133ce4f993775 100644
--- a/docs/content/docs/ops/upgrading.md
+++ b/docs/content/docs/ops/upgrading.md
@@ -279,6 +279,11 @@ For more details, please take a look at the [savepoint documentation]({{< ref "d
 
 Savepoints are compatible across Flink versions as indicated by the table below:
 
+**Note**: "Compatible" here refers specifically to compatibility of the internal data format in
+savepoints. It does not cover compatibility of SQL operators or other Upper-level changes. In
+practice, provided there are no changes to Flink SQL semantics, this state format compatibility
+typically also ensures job-level compatibility.
+
 <table class="table table-bordered" style="font-size:8pt">
   <thead>
     <tr>