diff --git a/docs/conf_common.py b/docs/conf_common.py
index 69dc764679..14f7de9f82 100644
--- a/docs/conf_common.py
+++ b/docs/conf_common.py
@@ -22,7 +22,7 @@ BT_DOCS = ['api-reference/bluetooth/esp_bt_defs.rst',
            'api-reference/bluetooth/bt_common.rst',
            'api-reference/bluetooth/bt_vhci.rst',
            'api-reference/bluetooth/controller_vhci.rst',
-           'api-reference/bluetooth/index.rst']
+           'api-reference/bluetooth/index.rst',]
 
 BLE_DOCS = ['api-guides/ble/index.rst',
             'api-guides/ble/overview.rst',
@@ -62,7 +62,9 @@ CLASSIC_BT_DOCS = ['api-guides/classic-bt/index.rst',
                    'api-reference/bluetooth/esp_hf_ag.rst',
                    'api-reference/bluetooth/esp_spp.rst',
                    'api-reference/bluetooth/esp_gap_bt.rst',
-                   'migration-guides/release-5.x/5.0/bluetooth-classic.rst']
+                   'migration-guides/release-5.x/5.0/bluetooth-classic.rst',
+                   'migration-guides/release-5.x/5.2/bluetooth-classic.rst',
+                   'migration-guides/release-5.x/5.3/bluetooth-classic.rst',]
 
 BLUFI_DOCS = ['api-guides/ble/blufi.rst',
               'api-reference/bluetooth/esp_blufi.rst']
@@ -76,7 +78,7 @@ WIFI_DOCS = ['api-guides/wifi.rst',
              'api-reference/network/esp_dpp.rst',
              'api-reference/provisioning/provisioning.rst',
              'api-reference/provisioning/wifi_provisioning.rst',
-             'migration-guides/release-5.x/5.2/wifi.rst']
+             'migration-guides/release-5.x/5.2/wifi.rst',]
 
 IEEE802154_DOCS = ['migration-guides/release-5.x/5.1/ieee802154.rst',
                    'migration-guides/release-5.x/5.2/ieee802154.rst']
diff --git a/docs/en/migration-guides/release-5.x/5.2/index.rst b/docs/en/migration-guides/release-5.x/5.2/index.rst
index e21d8018e6..41c7ca8656 100644
--- a/docs/en/migration-guides/release-5.x/5.2/index.rst
+++ b/docs/en/migration-guides/release-5.x/5.2/index.rst
@@ -13,4 +13,4 @@ Migration from 5.1 to 5.2
     storage
     system
     :SOC_WIFI_SUPPORTED: wifi
-    bluetooth-classic
+    :SOC_BT_CLASSIC_SUPPORTED: bluetooth-classic
diff --git a/docs/en/migration-guides/release-5.x/5.3/index.rst b/docs/en/migration-guides/release-5.x/5.3/index.rst
index 06147ed12a..2ba6fe6b67 100644
--- a/docs/en/migration-guides/release-5.x/5.3/index.rst
+++ b/docs/en/migration-guides/release-5.x/5.3/index.rst
@@ -6,7 +6,7 @@ Migration from 5.2 to 5.3
 .. toctree::
     :maxdepth: 1
 
-    bluetooth-classic
+    :SOC_BT_CLASSIC_SUPPORTED: bluetooth-classic
     gcc
     peripherals
     protocols
diff --git a/docs/zh_CN/migration-guides/release-5.x/5.2/index.rst b/docs/zh_CN/migration-guides/release-5.x/5.2/index.rst
index 0647016290..5452f3fb32 100644
--- a/docs/zh_CN/migration-guides/release-5.x/5.2/index.rst
+++ b/docs/zh_CN/migration-guides/release-5.x/5.2/index.rst
@@ -13,4 +13,4 @@
     storage
     system
     :SOC_WIFI_SUPPORTED: wifi
-    bluetooth-classic
+    :SOC_BT_CLASSIC_SUPPORTED: bluetooth-classic
diff --git a/docs/zh_CN/migration-guides/release-5.x/5.3/index.rst b/docs/zh_CN/migration-guides/release-5.x/5.3/index.rst
index 03d9124347..6baca58e16 100644
--- a/docs/zh_CN/migration-guides/release-5.x/5.3/index.rst
+++ b/docs/zh_CN/migration-guides/release-5.x/5.3/index.rst
@@ -6,7 +6,7 @@
 .. toctree::
     :maxdepth: 1
 
-    bluetooth-classic
+    :SOC_BT_CLASSIC_SUPPORTED: bluetooth-classic
     gcc
     peripherals
     protocols