MC4WP: Mailchimp for WordPress 4.15.0 has 43 actions and 58 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.
How to use these hooks
Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.
// Run your own code when MC4WP: Mailchimp for WordPress fires an action
add_action( 'mc4wp_admin_enqueue_assets', function( $arg1, $page ) {
// Your code runs here.
}, 10, 2 );
// Change a value MC4WP: Mailchimp for WordPress is about to use
add_filter( 'mc4wp_integration_buddypress_should_subscribe', function( $subscribe, $user_id ) {
// Change $subscribe here.
return $subscribe;
}, 10, 2 );Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.
All hooks
-
/** * Allow other plugins to prevent the Mailchimp sign-up. */ apply_filters( 'mc4wp_integration_buddypress_should_subscribe', $subscribe, $user_id ); -
mc4wp_lists
filter/** * Filters Mailchimp lists new subscribers should be added to. */ apply_filters( 'mc4wp_lists', $lists ); -
mc4wp_subscriber_data
filter/** * Filters subscriber data before it is sent to Mailchimp. Fires for both form * & integration requests. */ apply_filters( 'mc4wp_subscriber_data', $subscriber, $list_id ); -
mc4wp_admin_{$action}
action/** * Allows you to hook into requests containing `_mc4wp_action` => action name. */ do_action( "mc4wp_admin_{$action}" ); -
/** * Runs when outputting a tab section on the "edit form" screen */ do_action( "mc4wp_admin_edit_form_output_{$tab}_tab", $opts, $form ); -
mc4wp_admin_edit_form_tabs
filter/** * Filters the setting tabs on the "edit form" screen. */ apply_filters( 'mc4wp_admin_edit_form_tabs', $tabs ); -
mc4wp_admin_enqueue_assets
action/** * Hook to enqueue your own custom assets on the Mailchimp for WordPress * setting pages. */ do_action( 'mc4wp_admin_enqueue_assets', '', $page ); -
mc4wp_admin_form_css_options
filter/** * Filters the <option>'s in the "CSS Stylesheet" <select> box. */ apply_filters( 'mc4wp_admin_form_css_options', $css_options ); -
/** * Filters meta links shown on the Plugins overview page */ apply_filters( 'mc4wp_admin_plugin_meta_links', $links ); -
/** * Filters the required user capability to access the Mailchimp for WordPress' * settings pages, view the dashboard widgets. */ apply_filters( 'mc4wp_admin_required_capability', $capability ); -
mc4wp_admin_sidebar
action/** * Runs when the sidebar is outputted on Mailchimp for WordPress settings * pages. */ do_action( 'mc4wp_admin_sidebar' ); -
mc4wp_dashboard_setup
action/** * Setup dashboard widget, users are authorized by now. */ do_action( 'mc4wp_dashboard_setup' ); -
mc4wp_debug_log_file
filter/** * Filters the log file to write to. */ apply_filters( 'mc4wp_debug_log_file', $file ); -
mc4wp_debug_log_level
filter/** * Filters the minimum level to log messages. */ apply_filters( 'mc4wp_debug_log_level', $opts['debug_log_level'] ); -
mc4wp_debug_log_message
filter/** * Modifies the message that is written to the debug log. Return an empty * string to skip logging this message altogether. */ apply_filters( 'mc4wp_debug_log_message', $message ); -
/** * Filters the maximum length of a debug log message in bytes. */ apply_filters( 'mc4wp_debug_log_message_max_length', 8192 ); -
mc4wp_email_type
filter/** * Filters the email type preference for this new subscriber. */ apply_filters( 'mc4wp_email_type', $email_type ); -
mc4wp_form_action
filter/** * Filters the `action` attribute of the `<form>` element. */ apply_filters( 'mc4wp_form_action', $form_action_attribute, $form ); -
mc4wp_form_added_subscriber
action/** * Fires right after a form was used to add a new subscriber. */ do_action( 'mc4wp_form_added_subscriber', $form, $subscriber->email_address, $data ); -
mc4wp_form_after_fields
filter/** * Filters the HTML after the form fields. */ apply_filters( 'mc4wp_form_after_fields', $html, $form ); -
mc4wp_form_api_error
action/** * Fire action hook so API errors can be hooked into. */ do_action( 'mc4wp_form_api_error', $form, $error_message ); -
mc4wp_form_auto_scroll
filter/** * Filters the `auto_scroll` setting for when a form is submitted. Set to false * to disable scrolling to form. */ apply_filters( 'mc4wp_form_auto_scroll', $data['auto_scroll'] ); -
mc4wp_form_before_fields
filter/** * Filters the HTML before the form fields. */ apply_filters( 'mc4wp_form_before_fields', $html, $form ); -
mc4wp_form_content
filter/** * Filters the HTML for the form fields. */ apply_filters( 'mc4wp_form_content', $content, $form, $element ); -
mc4wp_form_css_classes
filter/** * Filters `class` attributes for the `<form>` element. */ apply_filters( 'mc4wp_form_css_classes', $classes, $form ); -
mc4wp_form_data
filter/** * Filters the form data. */ apply_filters( 'mc4wp_form_data', $data, $form ); -
/** * Filters all attributes to be added to the `<form>` element */ apply_filters( 'mc4wp_form_element_attributes', $attributes, $form ); -
mc4wp_form_error
action/** * Fires right after a form is submitted with errors. */ do_action( 'mc4wp_form_error', $form ); -
mc4wp_form_error_{$error}
action/** * Fires right after a form was submitted with errors. */ do_action( "mc4wp_form_error_{$error}", $form ); -
mc4wp_form_errors
filter/** * Filters whether this form has errors. Runs only when a form is submitted. * Expects an array of message keys with an error type (string). */ apply_filters( 'mc4wp_form_errors', $errors, $form ); -
/** * Filters field names which should be ignored when showing data. */ apply_filters( 'mc4wp_form_ignored_field_names', $ignored_field_names, $form ); -
mc4wp_form_lists
filter/** * Filters Mailchimp lists new subscribers coming from this form should be * added to. */ apply_filters( 'mc4wp_form_lists', $lists, $form ); -
mc4wp_form_messages
filter/** * Filters the default form messages */ apply_filters( 'mc4wp_form_messages', $messages, $form ); -
mc4wp_form_redirect_url
filter/** * Filters the redirect URL setting */ apply_filters( 'mc4wp_form_redirect_url', $url, $form ); -
mc4wp_form_required_fields
filter/** * Filters the required fields for a form */ apply_filters( 'mc4wp_form_required_fields', $required_fields, $form ); -
mc4wp_form_respond
action/** * Fires right before responding to the form request. */ do_action( 'mc4wp_form_respond', $form ); -
mc4wp_form_response_html
filter/** * Filter the form response HTML */ apply_filters( 'mc4wp_form_response_html', $html, $form ); -
mc4wp_form_response_position
filter/** * Filters the position for the form response. */ apply_filters( 'mc4wp_form_response_position', $position, $form ); -
mc4wp_form_sanitized_data
filter/** * Filters the form data just before it is saved. */ apply_filters( 'mc4wp_form_sanitized_data', $data, $raw_data ); -
mc4wp_form_settings
filter/** * Filters the form settings */ apply_filters( 'mc4wp_form_settings', $settings, $form ); -
mc4wp_form_stylesheets
filter/** * Filters the stylesheets to be loaded */ apply_filters( 'mc4wp_form_stylesheets', $stylesheets ); -
mc4wp_form_subscribed
action/** * Fires right after a form was used to add a new subscriber (or update an * existing one). */ do_action( 'mc4wp_form_subscribed', $form, $subscriber->email_address, $data, $map ); -
mc4wp_form_subscriber_data
filter/** * Filters subscriber data before it is sent to Mailchimp. Only fires for form * requests. */ apply_filters( 'mc4wp_form_subscriber_data', $subscriber, $list_id ); -
mc4wp_form_success
action/** * Fires right after a form is submitted without any errors (success). */ do_action( 'mc4wp_form_success', $form ); -
/** * Fires right after a form was used to update an existing subscriber. */ do_action( 'mc4wp_form_updated_subscriber', $form, $subscriber->email_address, $data ); -
mc4wp_form_widget_form
action/** * Runs right after the widget settings form is outputted */ do_action( 'mc4wp_form_widget_form', $settings, $widget ); -
/** * Filters the widget settings before they are saved. */ apply_filters( 'mc4wp_form_widget_update_settings', $new_settings, $old_settings, $this ); -
mc4wp_format_field_value
filter/** * Filters the value of a field after it is formatted. */ apply_filters( 'mc4wp_format_field_value', $value, $field_type ); -
mc4wp_http_request_args
filter/** * Filter the request arguments for all requests generated by this class */ apply_filters( 'mc4wp_http_request_args', $args, $url ); -
/** * Filters the attributes array. */ apply_filters( "mc4wp_integration_{$slug}_checkbox_attributes", $attributes, $integration ); -
/** * Filters the Mailchimp lists a specific integration should subscribe to */ apply_filters( "mc4wp_integration_{$slug}_lists", $lists, $integration ); -
/** * Filters options for a specific integration */ apply_filters( "mc4wp_integration_{$slug}_options", $options ); -
/** * Filters subscriber data before it is sent to Mailchimp. Only fires for * integration requests. */ apply_filters( "mc4wp_integration_{$slug}_subscriber_data", $subscriber, $related_object_id ); -
/** * Filters data for a specific integration request. */ apply_filters( "mc4wp_integration_{$this->slug}_data", $data, $related_object_id ); -
/** * Filters the attributes array. */ apply_filters( 'mc4wp_integration_checkbox_attributes', $attributes, $integration ); -
/** * Filters the checkbox label */ apply_filters( 'mc4wp_integration_checkbox_label', $label, $integration ); -
mc4wp_integration_data
filter/** * Filters data for integration requests. */ apply_filters( 'mc4wp_integration_data', $data ); -
mc4wp_integration_lists
filter/** * Filters the Mailchimp lists this integration should subscribe to */ apply_filters( 'mc4wp_integration_lists', $lists, $integration ); -
mc4wp_integration_options
filter/** * Filters global integration options */ apply_filters( 'mc4wp_integration_options', $options ); -
/** * Filters whether to show the sign-up checkbox for this integration. */ apply_filters( 'mc4wp_integration_show_checkbox', $show_checkbox, $integration_slug ); -
mc4wp_integration_subscribed
action/** * Runs right after someone is subscribed using an integration */ do_action( 'mc4wp_integration_subscribed', $integration, $subscriber->email_address, $subscriber->merge_fields, $map, $related_object_id ); -
/** * Filters subscriber data before it is sent to Mailchimp. Only fires for * integration requests. */ apply_filters( 'mc4wp_integration_subscriber_data', $subscriber ); -
mc4wp_integration_user_data
filter/** * Filters the data for user-related integrations */ apply_filters( 'mc4wp_integration_user_data', $data, $user ); -
mc4wp_lists_count_cache_time
filter/** * Filters the cache time for Mailchimp lists configuration, in seconds. * Defaults to 24 hours. */ apply_filters( 'mc4wp_lists_count_cache_time', HOUR_IN_SECONDS * 24 ); -
mc4wp_output_form
action/** * Runs just before a form element is outputted. */ do_action( 'mc4wp_output_form', $form ); -
mc4wp_save_form
action/** * Runs right after a form is updated. */ do_action( 'mc4wp_save_form', $form_id ); -
mc4wp_save_settings
action/** * Runs right before general settings are saved. */ do_action( 'mc4wp_save_settings', $settings, $current ); -
mc4wp_settings
filter/** * Filters the Mailchimp for WordPress settings (general). */ apply_filters( 'mc4wp_settings', $options ); -
mc4wp_subscriber_count
filter/** * Filters the total subscriber_count for the given List ID's. */ apply_filters( 'mc4wp_subscriber_count', $count, $list_ids ); -
mc4wp_load_form_scripts
filterapply_filters( 'mc4wp_load_form_scripts', true ); -
do_action( "mc4wp_admin_after_{$integration->slug}_integration_settings", $integration, $opts ); -
do_action( 'mc4wp_admin_after_general_settings' ); -
do_action( 'mc4wp_admin_after_integration_settings', $integration, $opts ); -
do_action( "mc4wp_admin_before_{$integration->slug}_integration_settings", $integration, $opts ); -
do_action( 'mc4wp_admin_before_integration_settings', $integration, $opts ); -
do_action( 'mc4wp_admin_before_other_settings', $opts ); -
do_action( 'mc4wp_admin_edit_form_after_title' ); -
do_action( 'mc4wp_admin_form_after_appearance_settings_rows', $opts, $form ); -
do_action( 'mc4wp_admin_form_after_behaviour_settings_rows', $opts, $form ); -
do_action( 'mc4wp_admin_form_after_mailchimp_settings_rows', $opts, $form ); -
do_action( 'mc4wp_admin_form_after_messages_settings_rows', [], $form ); -
do_action( 'mc4wp_admin_form_before_behaviour_settings_rows', $opts, $form ); -
do_action( 'mc4wp_admin_form_before_mailchimp_settings_rows', $opts, $form ); -
do_action( 'mc4wp_admin_form_before_messages_settings_rows', $opts, $form ); -
mc4wp_admin_other_settings
actiondo_action( 'mc4wp_admin_other_settings', $opts ); -
mc4wp_admin_show_forms_page
actiondo_action( 'mc4wp_admin_show_forms_page', $view ); -
do_action( "mc4wp_admin_show_forms_page-{$view}" ); -
apply_filters( 'mc4wp_email_typo_checker_domains', [ 'gmail.com', 'yahoo.com', 'hotmail.com', 'outlook.com', 'icloud.com', 'aol.com', 'live.com', 'msn.com', 'me.com', 'mac.com', 'googlemail.com', 'ymail.com', 'protonmail.com', 'mail.com', 'gmx.com', 'zoho.com', ] ); -
do_action( "mc4wp_integration_{$this->slug}_after_checkbox_wrapper", $this ); -
do_action( "mc4wp_integration_{$this->slug}_before_checkbox_wrapper", $this ); -
do_action( 'mc4wp_integration_after_checkbox_wrapper', $this ); -
do_action( 'mc4wp_integration_before_checkbox_wrapper', $this ); -
apply_filters( 'mc4wp_integration_gravity-forms_options', $options ); -
do_action( 'mc4wp_integration_ninja_forms_subscribe', $email_address, $merge_fields, $list_id, $double_optin, $update_existing, $replace_interests, $form_id ); -
mc4wp_load_form_scripts
actiondo_action( 'mc4wp_load_form_scripts' ); -
mc4wp_load_form_stylesheets
actiondo_action( 'mc4wp_load_form_stylesheets', $stylesheets ); -
mc4wp_use_sslverify
filterapply_filters( 'mc4wp_use_sslverify', true ); -
mc4wp_user_merge_vars
filterapply_filters( 'mc4wp_user_merge_vars', $data, $user ); -
widget_title
filterapply_filters( 'widget_title', $instance_settings['title'], $instance_settings, $this->id_base );
Generated from MC4WP: Mailchimp for WordPress's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Can't find the right hook?
We can build the customisation for you. Describe what you need: