diff --git a/lib/upgrade.txt b/lib/upgrade.txt
index 0bb5219b22c..27e99b3a785 100644
--- a/lib/upgrade.txt
+++ b/lib/upgrade.txt
@@ -2,6 +2,8 @@ This files describes API changes in core libraries and APIs,
 information provided here is intended especially for developers.
 === 2.5.2 ===
 * Use new function moodleform::mock_submit() to simulate form submission in unit tests.
+* Use behat_selectors::get_allowed_text_selectors() and behat_selectors::get_allowed_selectors() instead of
+  behat_command::$allowedtextselectors and behat_command::$allowedselectors
 
 === 2.5.1 ===