diff --git a/docs/en/api-guides/wifi.rst b/docs/en/api-guides/wifi.rst
index 0410e84680..7b9b3b347e 100644
--- a/docs/en/api-guides/wifi.rst
+++ b/docs/en/api-guides/wifi.rst
@@ -1023,6 +1023,8 @@ The beacon timeout mechanism is used by {IDF_TARGET_NAME} station to detect whet
 
 After the beacon times out, the station sends 5 probe requests to the AP. If still no probe response or beacon is received from AP, the station disconnects from the AP and raises the event `WIFI_EVENT_STA_DISCONNECTED`_.
 
+It should be considered that the timer used for beacon timeout will be reset during the scanning process. It means that the scan process will affect the triggering of the event `WIFI_EVENT_STA_BEACON_TIMEOUT`_.
+
 {IDF_TARGET_NAME} Wi-Fi Configuration
 -------------------------------------
 
diff --git a/docs/zh_CN/api-guides/wifi.rst b/docs/zh_CN/api-guides/wifi.rst
index 6476920497..45415895b9 100644
--- a/docs/zh_CN/api-guides/wifi.rst
+++ b/docs/zh_CN/api-guides/wifi.rst
@@ -1023,6 +1023,8 @@ Wi-Fi beacon 超时
 
 beacon 超时发生后，station 将向 AP 发送 5 个 probe request，如果仍未从 AP 接收到 probe response 或 beacon，station 将与 AP 断开连接并产生 `WIFI_EVENT_STA_DISCONNECTED`_ 事件。
 
+需要注意的是，扫描过程中会重置 beacon 超时所使用的定时器，即扫描过程会影响 `WIFI_EVENT_STA_BEACON_TIMEOUT`_ 事件的触发。
+
 {IDF_TARGET_NAME} Wi-Fi 配置
 -------------------------------------