diff --git a/system-variables.md b/system-variables.md
index f030c70c3795..14d5c711f6b2 100644
--- a/system-variables.md
+++ b/system-variables.md
@@ -3734,6 +3734,16 @@ v5.0 后，用户仍可以单独修改以上系统变量（会有废弃警告）
 - 默认值：`1.5`
 - 表示 TiDB 往临时磁盘读写一个字节数据的 I/O 开销。该变量是[代价模型](/cost-model.md)内部使用的变量，**不建议**修改该变量的值。
 
+### `tidb_opt_index_join_max_scan_rows_ratio`
+
+- 作用域：SESSION | GLOBAL
+- 是否持久化到集群：是
+- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是
+- 类型：浮点数
+- 范围：`[0, 18446744073709551615]`
+- 默认值：`0`
+- 表示当 IndexJoin 所要处理的总行数是 HashJoin 要处理的总行数的比例大于该变量时，直接强制放弃 IndexJoin
+
 ### `tidb_opt_distinct_agg_push_down`
 
 - 作用域：SESSION