diff --git a/docs/en/migration-guides/release-5.x/5.4/index.rst b/docs/en/migration-guides/release-5.x/5.4/index.rst
index 08ce135e44..f6b85cb5e7 100644
--- a/docs/en/migration-guides/release-5.x/5.4/index.rst
+++ b/docs/en/migration-guides/release-5.x/5.4/index.rst
@@ -10,3 +10,4 @@ Migration from 5.3 to 5.4
     system
     bluetooth-classic
     storage
+    wifi
diff --git a/docs/en/migration-guides/release-5.x/5.4/wifi.rst b/docs/en/migration-guides/release-5.x/5.4/wifi.rst
new file mode 100644
index 0000000000..ddcc2c49f1
--- /dev/null
+++ b/docs/en/migration-guides/release-5.x/5.4/wifi.rst
@@ -0,0 +1,22 @@
+Wi-Fi
+======
+
+:link_to_translation:`zh_CN:[中文]`
+
+
+Wi-Fi Scan and Connect
+------------------------
+
+    The following types have been modified:
+
+    - :component_file:`esp_wifi/include/esp_wifi_he_types.h`
+
+        - :cpp:struct:`esp_wifi_htc_omc_t`:
+
+            - ``uph_id``, ``ul_pw_headroom``, ``min_tx_pw_flag`` are deprecated.
+
+    - :component_file:`esp_wifi/include/esp_wifi_types_generic.h`
+
+        - :cpp:struct:`wifi_ap_record_t`:
+
+            - The type of ``bandwidth`` has been changed from ``uint8_t`` to ``wifi_bandwidth_t``
diff --git a/docs/zh_CN/migration-guides/release-5.x/5.4/index.rst b/docs/zh_CN/migration-guides/release-5.x/5.4/index.rst
index 5d15a086f3..e2256533e9 100644
--- a/docs/zh_CN/migration-guides/release-5.x/5.4/index.rst
+++ b/docs/zh_CN/migration-guides/release-5.x/5.4/index.rst
@@ -10,3 +10,4 @@
     system
     bluetooth-classic
     storage
+    wifi
diff --git a/docs/zh_CN/migration-guides/release-5.x/5.4/wifi.rst b/docs/zh_CN/migration-guides/release-5.x/5.4/wifi.rst
new file mode 100644
index 0000000000..ed9be5db8d
--- /dev/null
+++ b/docs/zh_CN/migration-guides/release-5.x/5.4/wifi.rst
@@ -0,0 +1,24 @@
+Wi-Fi
+=====
+
+:link_to_translation:`en:[English]`
+
+
+Wi-Fi 扫描和连接
+------------------------
+
+    以下类型已被更改：
+    - :component_file:`esp_wifi/include/esp_wifi_he_types.h`
+
+        - :cpp:struct:`esp_wifi_htc_omc_t` 中:
+
+            - ``uph_id``， ``ul_pw_headroom``， ``min_tx_pw_flag`` 字段被弃用
+
+    - :component_file:`esp_wifi/include/esp_wifi_types_generic.h`
+
+        - :cpp:struct:`wifi_ap_record_t` 中:
+
+            - ``bandwidth`` 的类型从 ``uint8_t`` 更改为 ``wifi_bandwidth_t``
+
+
+