diff --git a/docs/conf_common.py b/docs/conf_common.py
index 6e43ca6600..645ff657f1 100644
--- a/docs/conf_common.py
+++ b/docs/conf_common.py
@@ -34,7 +34,8 @@ BT_DOCS = ['api-guides/blufi.rst',
            'api-reference/bluetooth/esp_blufi.rst',
            'api-reference/bluetooth/esp-ble-mesh.rst',
            'api-reference/bluetooth/index.rst',
-           'api-reference/bluetooth/nimble/index.rst']
+           'api-reference/bluetooth/nimble/index.rst',
+           'migration-guides/release-5.x/bluetooth-low-energy.rst']
 
 CLASSIC_BT_DOCS = ['api-reference/bluetooth/classic_bt.rst',
                    'api-reference/bluetooth/esp_a2dp.rst',
diff --git a/docs/en/migration-guides/release-5.x/index.rst b/docs/en/migration-guides/release-5.x/index.rst
index eaf292ec93..44ccc789be 100644
--- a/docs/en/migration-guides/release-5.x/index.rst
+++ b/docs/en/migration-guides/release-5.x/index.rst
@@ -7,7 +7,7 @@ Migration from 4.4 to 5.0
     :maxdepth: 1
 
     :SOC_BT_CLASSIC_SUPPORTED: bluetooth-classic
-    bluetooth-low-energy
+    :SOC_BLE_SUPPORTED: bluetooth-low-energy
     build-system
     gcc
     networking
diff --git a/docs/zh_CN/migration-guides/release-5.x/index.rst b/docs/zh_CN/migration-guides/release-5.x/index.rst
index c5970670e0..4b476cfa3f 100644
--- a/docs/zh_CN/migration-guides/release-5.x/index.rst
+++ b/docs/zh_CN/migration-guides/release-5.x/index.rst
@@ -7,7 +7,7 @@
     :maxdepth: 1
 
     :SOC_BT_CLASSIC_SUPPORTED: bluetooth-classic
-    bluetooth-low-energy
+    :SOC_BLE_SUPPORTED: bluetooth-low-energy
     build-system
     gcc
     networking