diff --git a/examples/docs/en-US/message-box.md b/examples/docs/en-US/message-box.md
index c5ae085ff..0cf28380f 100644
--- a/examples/docs/en-US/message-box.md
+++ b/examples/docs/en-US/message-box.md
@@ -238,6 +238,8 @@ The corresponding methods are: `MessageBox`, `MessageBox.alert`, `MessageBox.con
 | confirmButtonText | text content of confirm button | string | — | OK |
 | cancelButtonClass | custom class name of cancel button | string | — | — |
 | confirmButtonClass | custom class name of confirm button | string | — | — |
+| closeOnClickModal | whether MessageBox can be closed by clicking the mask | boolean | — | true (false when called with alert) |
+| closeOnPressEscape | whether MessageBox can be closed by pressing the ESC | boolean | — | false |
 | showInput | whether to show an input | boolean | — | false (true when called with prompt) |
 | inputPlaceholder | placeholder of input | string | — | — |
 | inputPattern | regexp for the input | regexp | — | — |
diff --git a/examples/docs/zh-CN/message-box.md b/examples/docs/zh-CN/message-box.md
index eb7d39b1e..e2fb24e6b 100644
--- a/examples/docs/zh-CN/message-box.md
+++ b/examples/docs/zh-CN/message-box.md
@@ -235,6 +235,8 @@ import { MessageBox } from 'element-ui';
 | confirmButtonText | 确定按钮的文本内容 | string | — | 确定 |
 | cancelButtonClass | 取消按钮的自定义类名 | string | — | — |
 | confirmButtonClass | 确定按钮的自定义类名 | string | — | — |
+| closeOnClickModal | 是否可通过点击遮罩关闭 MessageBox | boolean | — | true（以 alert 方式调用时为 false） |
+| closeOnPressEscape | 是否可通过按下 ESC 键关闭 MessageBox | boolean | — | false |
 | showInput | 是否显示输入框 | boolean | — | false（以 prompt 方式调用时为 true）|
 | inputPlaceholder | 输入框的占位符 | string | — | — |
 | inputPattern | 输入框的校验表达式 | regexp | — | — |