diff --git a/wp-includes/kses.php b/wp-includes/kses.php
index a3fa334e7e..4c42134e7a 100644
--- a/wp-includes/kses.php
+++ b/wp-includes/kses.php
@@ -34,6 +34,11 @@
 /**
  * You can override this in a plugin.
  *
+ * The wp_kses_allowed_html filter is more powerful and supplies context.
+ * CUSTOM_TAGS is not recommended and should be considered deprecated.
+ *
+ * @see wp_kses_allowed_html()
+ *
  * @since 1.2.0
  */
 if ( ! defined( 'CUSTOM_TAGS' ) )