diff --git a/docs/config/transports/websocket.md b/docs/config/transports/websocket.md
index 0bca64302..96a3841bc 100644
--- a/docs/config/transports/websocket.md
+++ b/docs/config/transports/websocket.md
@@ -19,7 +19,8 @@ Websocket 会识别 HTTP 请求的 X-Forwarded-For 头来覆写流量的源地
   "host": "xray.com",
   "headers": {
     "key": "value"
-  }
+  },
+  "heartbeatPeriod": 10
 }
 ```
 
@@ -53,6 +54,10 @@ WebSocket 的HTTP请求中所发送的host，默认值为空。若服务端值
 
 默认值为空。
 
+> `heartbeatPeriod`: int
+
+指定间隔固定时间发送一个 Ping message 保活连接。不指定或指定为0时不发送 Ping message，为当前默认行为。
+
 ## Browser Dialer
 
 使用浏览器处理 TLS，详见 [Browser Dialer](../features/browser_dialer.md)