This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Comment Blacklist Manager


Comment Blacklist Manager will retrieve a list of blacklist terms from a remote source and update the blacklist_keys setting in WordPress. The list will update itself on a schedule to keep your terms current. Any manually added items will be retained, and an exclusions list is also created if there are terms from the source you want to allow.

The default data for the list is fetched from GitHub and is managed by Grant Hutchinson. The source can be changed based using available filters.


  • The new exclusions field


  1. Upload the comment-blacklist-manager folder to the /wp-content/plugins/ directory or install from the dashboard
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Add any terms to the exclusions list under the main “Discussions” settings area
  4. Add any additional terms in the new “Local Blacklist” field


What is the default source of the blacklist?

The list is managed by Grant Hutchinson on GitHub

Can I provide my own blacklist sources?

Sure can. Use the filter cblm_sources to add different source URLs.

to replace the sources completely

add_filter( 'cblm_sources', 'rkv_cblm_replace_blacklist_sources' );

function rkv_cblm_replace_blacklist_sources( $list ) {

    return array(


to add a new item to the existing sources

add_filter( 'cblm_sources', 'rkv_cblm_add_blacklist_source' );

function rkv_cblm_add_blacklist_source( $list ) {

    $list[] = '';

    return $list;


The plugin expects the blacklist data to be a plain text format with each entry on it’s own line. If the source is provided in a different format (a JSON feed or serialized array) then you will need to run the result through cblm_parse_data_result, which passes through the data and the source URL.

Can I change the update schedule?

Yep. Use the filter cblm_update_schedule to add a new URL.

add_filter( 'cblm_update_schedule', 'rkv_cblm_custom_schedule' );

function rkv_cblm_custom_schedule( $time ) {

    return DAY_IN_SECONDS;


The return should be provided using the time contstants in transients


Great Little Plugin

Does as advertised. I especially liked how you can exclude words from the automated blacklist if they don’t suit your website.

Read all 5 reviews

Contributors & Developers

“Comment Blacklist Manager” is open source software. The following people have contributed to this plugin.




  • Initial release