diff --git a/tools/idf_py_actions/hints.yml b/tools/idf_py_actions/hints.yml
index 2dd1fa59acf..fd5acb79643 100644
--- a/tools/idf_py_actions/hints.yml
+++ b/tools/idf_py_actions/hints.yml
@@ -601,3 +601,7 @@
 -
     re: "undefined reference to `esp_secure_boot_check_signature_on_update'"
     hint: "CONFIG_SECURE_SIGNED_ON_UPDATE_NO_SECURE_BOOT requires the startup signature check from the esp_image_verify component, which is not in the build. Add esp_image_verify (or app_update, which includes it) to the calling component's PRIV_REQUIRES or to the project's COMPONENTS list."
+
+-
+    re: "Build property 'BUILD_COMPONENTS' is not supported"
+    hint: "The 'BUILD_COMPONENTS' build property does not exist in Build System v2, since components are not collected before they are evaluated. To check whether a component takes part in the build, use the '$<TARGET_EXISTS:idf::component_name>' generator expression instead. For details and a migration example, run 'idf.py docs -sp api-guides/build-system-v2/breaking-changes.html#cmakev2-build-components'"
diff --git a/tools/test_idf_py/error_output.yml b/tools/test_idf_py/error_output.yml
index 6a157709aef..235c1222a9c 100644
--- a/tools/test_idf_py/error_output.yml
+++ b/tools/test_idf_py/error_output.yml
@@ -1,3 +1,6 @@
+"CMake Error at /esp-idf/tools/cmakev2/build.cmake:93 (message): IDF: Build property 'BUILD_COMPONENTS' is not supported\n":
+    "HINT: The 'BUILD_COMPONENTS' build property does not exist in Build System v2, since components are not collected before they are evaluated. To check whether a component takes part in the build, use the '$<TARGET_EXISTS:idf::component_name>' generator expression instead. For details and a migration example, run 'idf.py docs -sp api-guides/build-system-v2/breaking-changes.html#cmakev2-build-components'"
+
 'ccache error: Failed to create temporary file\n':
     "HINT: On Windows, you should enable long path support in the installer, or disable ccache temporarily. See 'idf.py --help' or the documentation how to achieve this."