diff --git a/data-type-numeric.md b/data-type-numeric.md
index a1644ce6580a..6a609d9b505d 100644
--- a/data-type-numeric.md
+++ b/data-type-numeric.md
@@ -18,6 +18,10 @@ TiDB 支持 MySQL 所有的整数类型，包括 `INTEGER`/`INT`、`TINYINT`、`
 
 字段说明：
 
+> **警告：**
+>
+> 从 v8.5.0 开始，整数显示宽度功能已废弃（[`deprecate-integer-display-length`](/tidb-configuration-file.md#deprecate-integer-display-length) 默认为 `true`）。不建议为整数类型指定显示宽度。
+
 | 语法元素 | 说明 |
 | ---- | --------|
 | M | 类型显示宽度，可选 |
diff --git a/data-type-overview.md b/data-type-overview.md
index 038ab9b2722b..90e50acd8499 100644
--- a/data-type-overview.md
+++ b/data-type-overview.md
@@ -12,5 +12,10 @@ TiDB 支持除空间类型 (`SPATIAL`) 之外的所有 MySQL 数据类型，包
 
 * `T` 表示具体的类型。
 * `M` 在整数类型中表示最大显示长度；在浮点数或者定点数中表示精度；在字符类型中表示最大长度。`M` 的最大值取决于具体的类型。
+
+    > **警告：**
+    >
+    > 从 v8.5.0 开始，整数显示宽度功能已废弃（[`deprecate-integer-display-length`](/tidb-configuration-file.md#deprecate-integer-display-length) 默认为 `true`）。不建议为整数类型指定显示宽度。
+
 * `D` 表示浮点数、定点数的小数位长度。
 * `fsp` 在时间和日期类型里的 `TIME`、`DATETIME` 以及 `TIMESTAMP` 中表示秒的精度，其取值范围是 0 到 6。值为 0 表示没有小数部分。如果省略，则默认精度为 0。
diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md
index 425ba5722848..74784ed7d113 100644
--- a/tidb-configuration-file.md
+++ b/tidb-configuration-file.md
@@ -183,7 +183,7 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/
 ### `deprecate-integer-display-length`
 
 + 当此配置项设置为 `true` 时，弃用整数类型的显示宽度。
-+ 默认值：`false`
++ 默认值：`true`。在 v8.5.0 之前，默认值为 `false`。
 
 ### `enable-tcp4-only` <span class="version-mark">从 v5.0 版本开始引入</span>