diff --git a/.upgradenotes/MDL-82427-2024070901230429.yml b/.upgradenotes/MDL-82427-2024070901230429.yml
index 07ba3446eaf..56e5c216f69 100644
--- a/.upgradenotes/MDL-82427-2024070901230429.yml
+++ b/.upgradenotes/MDL-82427-2024070901230429.yml
@@ -2,5 +2,5 @@ issueNumber: MDL-82427
 notes:
   core_filters:
     - message: >-
-        Added support for autoloading of filters from `\filter_filtername\filter`. The existing class names are still supported.
+        Added support for autoloading of filters from `\filter_[filtername]\filter`. Existing classes should be renamed to use the new namespace.
       type: improved
diff --git a/filter/classes/filter_manager.php b/filter/classes/filter_manager.php
index dfb315eeb38..ab87b07b10a 100644
--- a/filter/classes/filter_manager.php
+++ b/filter/classes/filter_manager.php
@@ -139,6 +139,13 @@ class filter_manager {
 
         $filterclassname = 'filter_' . $filtername;
         if (class_exists($filterclassname)) {
+            debugging(
+                "Inclusion of filters from 'filter/{$filtername}/filter.php' " .
+                    "using the '{$filterclassname}' class naming has been deprecated. " .
+                    "Please rename your class to {$filterclass} and move it to 'filter/{$filtername}/classes/text_filter.php'. " .
+                    "See MDL-82427 for more information.",
+                DEBUG_DEVELOPER,
+            );
             return new $filterclassname($context, $localconfig);
         }