MC4WP: Mailchimp for WordPress icon
Email & Marketing

MC4WP: Mailchimp for WordPress hooks reference

  • By Danny van Kooten
  • v4.15.0
  • Updated

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.

functions.phpyour child theme
// 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

  • integrations/buddypress/class-buddypress.php line 93 · used in 2 places
    /**
     * Allow other plugins to prevent the Mailchimp sign-up.
     */
    apply_filters( 'mc4wp_integration_buddypress_should_subscribe', $subscribe, $user_id );
  • mc4wp_lists

    filter
    includes/forms/class-form.php line 650 · used in 2 places
    /**
     * Filters Mailchimp lists new subscribers should be added to.
     */
    apply_filters( 'mc4wp_lists', $lists );
  • includes/forms/class-form-listener.php line 113 · used in 2 places
    /**
     * Filters subscriber data before it is sent to Mailchimp. Fires for both form
     * & integration requests.
     */
    apply_filters( 'mc4wp_subscriber_data', $subscriber, $list_id );
  • includes/admin/class-admin.php line 137
    /**
     * Allows you to hook into requests containing `_mc4wp_action` => action name.
     */
    do_action( "mc4wp_admin_{$action}" );
  • includes/forms/views/edit-form.php line 111
    /**
     * Runs when outputting a tab section on the "edit form" screen
     */
    do_action( "mc4wp_admin_edit_form_output_{$tab}_tab", $opts, $form );
  • includes/forms/views/edit-form.php line 23
    /**
     * Filters the setting tabs on the "edit form" screen.
     */
    apply_filters( 'mc4wp_admin_edit_form_tabs', $tabs );
  • includes/admin/class-admin.php line 349
    /**
     * Hook to enqueue your own custom assets on the Mailchimp for WordPress
     * setting pages.
     */
    do_action( 'mc4wp_admin_enqueue_assets', '', $page );
  • includes/forms/views/tabs/form-appearance.php line 23
    /**
     * Filters the <option>'s in the "CSS Stylesheet" <select> box.
     */
    apply_filters( 'mc4wp_admin_form_css_options', $css_options );
  • includes/admin/class-admin.php line 395
    /**
     * Filters the menu items to appear under the main menu item.
     */
    apply_filters( 'mc4wp_admin_menu_items', $menu_items );
  • includes/admin/class-admin-tools.php line 61
    /**
     * Filters the required user capability to access the Mailchimp for WordPress'
     * settings pages, view the dashboard widgets.
     */
    apply_filters( 'mc4wp_admin_required_capability', $capability );
  • includes/views/parts/admin-sidebar.php line 61
    /**
     * Runs when the sidebar is outputted on Mailchimp for WordPress settings
     * pages.
     */
    do_action( 'mc4wp_admin_sidebar' );
  • includes/admin/class-admin.php line 169
    /**
     * Setup dashboard widget, users are authorized by now.
     */
    do_action( 'mc4wp_dashboard_setup' );
  • includes/functions.php line 137
    /**
     * Filters the log file to write to.
     */
    apply_filters( 'mc4wp_debug_log_file', $file );
  • includes/functions.php line 170
    /**
     * Filters the minimum level to log messages.
     */
    apply_filters( 'mc4wp_debug_log_level', $opts['debug_log_level'] );
  • includes/class-debug-log.php line 105
    /**
     * 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 );
  • includes/functions.php line 530
    /**
     * Filters the maximum length of a debug log message in bytes.
     */
    apply_filters( 'mc4wp_debug_log_message_max_length', 8192 );
  • includes/functions.php line 439
    /**
     * Filters the email type preference for this new subscriber.
     */
    apply_filters( 'mc4wp_email_type', $email_type );
  • includes/forms/class-form-element.php line 255
    /**
     * Filters the `action` attribute of the `<form>` element.
     */
    apply_filters( 'mc4wp_form_action', $form_action_attribute, $form );
  • includes/forms/class-form-listener.php line 192
    /**
     * Fires right after a form was used to add a new subscriber.
     */
    do_action( 'mc4wp_form_added_subscriber', $form, $subscriber->email_address, $data );
  • includes/forms/class-form-element.php line 223
    /**
     * Filters the HTML after the form fields.
     */
    apply_filters( 'mc4wp_form_after_fields', $html, $form );
  • includes/forms/class-form-listener.php line 155
    /**
     * Fire action hook so API errors can be hooked into.
     */
    do_action( 'mc4wp_form_api_error', $form, $error_message );
  • includes/forms/class-asset-manager.php line 157
    /**
     * 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'] );
  • includes/forms/class-form-element.php line 197
    /**
     * Filters the HTML before the form fields.
     */
    apply_filters( 'mc4wp_form_before_fields', $html, $form );
  • includes/forms/class-form-element.php line 71
    /**
     * Filters the HTML for the form fields.
     */
    apply_filters( 'mc4wp_form_content', $content, $form, $element );
  • includes/forms/class-form-element.php line 376
    /**
     * Filters `class` attributes for the `<form>` element.
     */
    apply_filters( 'mc4wp_form_css_classes', $classes, $form );
  • includes/forms/class-form.php line 718
    /**
     * Filters the form data.
     */
    apply_filters( 'mc4wp_form_data', $data, $form );
  • includes/forms/class-form-element.php line 266
    /**
     * Filters all attributes to be added to the `<form>` element
     */
    apply_filters( 'mc4wp_form_element_attributes', $attributes, $form );
  • includes/forms/class-form-listener.php line 251
    /**
     * Fires right after a form is submitted with errors.
     */
    do_action( 'mc4wp_form_error', $form );
  • includes/forms/class-form-listener.php line 274
    /**
     * Fires right after a form was submitted with errors.
     */
    do_action( "mc4wp_form_error_{$error}", $form );
  • includes/forms/class-form.php line 454
    /**
     * 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 );
  • includes/forms/class-form.php line 581
    /**
     * Filters field names which should be ignored when showing data.
     */
    apply_filters( 'mc4wp_form_ignored_field_names', $ignored_field_names, $form );
  • includes/forms/class-form.php line 658
    /**
     * Filters Mailchimp lists new subscribers coming from this form should be
     * added to.
     */
    apply_filters( 'mc4wp_form_lists', $lists, $form );
  • includes/forms/class-form.php line 299
    /**
     * Filters the default form messages
     */
    apply_filters( 'mc4wp_form_messages', $messages, $form );
  • includes/forms/class-form.php line 388
    /**
     * Filters the redirect URL setting
     */
    apply_filters( 'mc4wp_form_redirect_url', $url, $form );
  • includes/forms/class-form.php line 776
    /**
     * Filters the required fields for a form
     */
    apply_filters( 'mc4wp_form_required_fields', $required_fields, $form );
  • includes/forms/class-form-listener.php line 285
    /**
     * Fires right before responding to the form request.
     */
    do_action( 'mc4wp_form_respond', $form );
  • includes/forms/class-form-element.php line 146
    /**
     * Filter the form response HTML
     */
    apply_filters( 'mc4wp_form_response_html', $html, $form );
  • includes/forms/class-form-element.php line 175
    /**
     * Filters the position for the form response.
     */
    apply_filters( 'mc4wp_form_response_position', $position, $form );
  • includes/forms/class-admin.php line 282
    /**
     * Filters the form data just before it is saved.
     */
    apply_filters( 'mc4wp_form_sanitized_data', $data, $raw_data );
  • includes/forms/class-form.php line 272
    /**
     * Filters the form settings
     */
    apply_filters( 'mc4wp_form_settings', $settings, $form );
  • includes/forms/class-asset-manager.php line 98
    /**
     * Filters the stylesheets to be loaded
     */
    apply_filters( 'mc4wp_form_stylesheets', $stylesheets );
  • includes/forms/class-form-listener.php line 205
    /**
     * 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 );
  • includes/forms/class-form-listener.php line 124
    /**
     * Filters subscriber data before it is sent to Mailchimp. Only fires for form
     * requests.
     */
    apply_filters( 'mc4wp_form_subscriber_data', $subscriber, $list_id );
  • includes/forms/class-form-listener.php line 241
    /**
     * Fires right after a form is submitted without any errors (success).
     */
    do_action( 'mc4wp_form_success', $form );
  • includes/forms/class-form-listener.php line 177
    /**
     * Fires right after a form was used to update an existing subscriber.
     */
    do_action( 'mc4wp_form_updated_subscriber', $form, $subscriber->email_address, $data );
  • includes/forms/class-widget.php line 98
    /**
     * Runs right after the widget settings form is outputted
     */
    do_action( 'mc4wp_form_widget_form', $settings, $widget );
  • includes/forms/class-widget.php line 140
    /**
     * Filters the widget settings before they are saved.
     */
    apply_filters( 'mc4wp_form_widget_update_settings', $new_settings, $old_settings, $this );
  • includes/class-list-data-mapper.php line 181
    /**
     * Filters the value of a field after it is formatted.
     */
    apply_filters( 'mc4wp_format_field_value', $value, $field_type );
  • includes/api/class-api-v3-client.php line 144
    /**
     * Filter the request arguments for all requests generated by this class
     */
    apply_filters( 'mc4wp_http_request_args', $args, $url );
  • includes/integrations/class-integration.php line 261
    /**
     * Filters the attributes array.
     */
    apply_filters( "mc4wp_integration_{$slug}_checkbox_attributes", $attributes, $integration );
  • includes/integrations/class-integration.php line 397
    /**
     * Filters the Mailchimp lists a specific integration should subscribe to
     */
    apply_filters( "mc4wp_integration_{$slug}_lists", $lists, $integration );
  • includes/integrations/class-integration.php line 109
    /**
     * Filters options for a specific integration
     */
    apply_filters( "mc4wp_integration_{$slug}_options", $options );
  • includes/integrations/class-integration.php line 524
    /**
     * 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 );
  • includes/integrations/class-integration.php line 436
    /**
     * Filters data for a specific integration request.
     */
    apply_filters( "mc4wp_integration_{$this->slug}_data", $data, $related_object_id );
  • includes/integrations/class-integration.php line 250
    /**
     * Filters the attributes array.
     */
    apply_filters( 'mc4wp_integration_checkbox_attributes', $attributes, $integration );
  • includes/integrations/class-integration.php line 194
    /**
     * Filters the checkbox label
     */
    apply_filters( 'mc4wp_integration_checkbox_label', $label, $integration );
  • includes/integrations/class-integration.php line 426
    /**
     * Filters data for integration requests.
     */
    apply_filters( 'mc4wp_integration_data', $data );
  • includes/integrations/class-integration.php line 385
    /**
     * Filters the Mailchimp lists this integration should subscribe to
     */
    apply_filters( 'mc4wp_integration_lists', $lists, $integration );
  • includes/integrations/class-integration-manager.php line 194
    /**
     * Filters global integration options
     */
    apply_filters( 'mc4wp_integration_options', $options );
  • includes/integrations/class-integration.php line 291
    /**
     * Filters whether to show the sign-up checkbox for this integration.
     */
    apply_filters( 'mc4wp_integration_show_checkbox', $show_checkbox, $integration_slug );
  • includes/integrations/class-integration.php line 558
    /**
     * 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 );
  • includes/integrations/class-integration.php line 511
    /**
     * Filters subscriber data before it is sent to Mailchimp. Only fires for
     * integration requests.
     */
    apply_filters( 'mc4wp_integration_subscriber_data', $subscriber );
  • includes/integrations/class-user-integration.php line 55
    /**
     * Filters the data for user-related integrations
     */
    apply_filters( 'mc4wp_integration_user_data', $data, $user );
  • includes/class-mailchimp.php line 456
    /**
     * 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 );
  • includes/forms/class-output-manager.php line 136
    /**
     * Runs just before a form element is outputted.
     */
    do_action( 'mc4wp_output_form', $form );
  • includes/forms/class-admin.php line 232
    /**
     * Runs right after a form is updated.
     */
    do_action( 'mc4wp_save_form', $form_id );
  • includes/admin/class-admin.php line 296
    /**
     * Runs right before general settings are saved.
     */
    do_action( 'mc4wp_save_settings', $settings, $current );
  • includes/functions.php line 77
    /**
     * Filters the Mailchimp for WordPress settings (general).
     */
    apply_filters( 'mc4wp_settings', $options );
  • includes/class-mailchimp.php line 602
    /**
     * Filters the total subscriber_count for the given List ID's.
     */
    apply_filters( 'mc4wp_subscriber_count', $count, $list_ids );
  • includes/forms/class-asset-manager.php line 167 · used in 2 places
    apply_filters( 'mc4wp_load_form_scripts', true );
  • includes/integrations/views/integration-settings.php line 327
    do_action( "mc4wp_admin_after_{$integration->slug}_integration_settings", $integration, $opts );
  • includes/views/general-settings.php line 71
    do_action( 'mc4wp_admin_after_general_settings' );
  • includes/integrations/views/integration-settings.php line 326
    do_action( 'mc4wp_admin_after_integration_settings', $integration, $opts );
  • includes/integrations/views/integration-settings.php line 43
    do_action( "mc4wp_admin_before_{$integration->slug}_integration_settings", $integration, $opts );
  • includes/integrations/views/integration-settings.php line 42
    do_action( 'mc4wp_admin_before_integration_settings', $integration, $opts );
  • includes/views/other-settings.php line 29
    do_action( 'mc4wp_admin_before_other_settings', $opts );
  • includes/forms/views/edit-form.php line 40
    do_action( 'mc4wp_admin_edit_form_after_title' );
  • includes/forms/views/tabs/form-appearance.php line 57
    do_action( 'mc4wp_admin_form_after_appearance_settings_rows', $opts, $form );
  • includes/forms/views/tabs/form-settings.php line 201
    do_action( 'mc4wp_admin_form_after_behaviour_settings_rows', $opts, $form );
  • includes/forms/views/tabs/form-settings.php line 143
    do_action( 'mc4wp_admin_form_after_mailchimp_settings_rows', $opts, $form );
  • includes/forms/views/tabs/form-messages.php line 91
    do_action( 'mc4wp_admin_form_after_messages_settings_rows', [], $form );
  • includes/forms/views/tabs/form-settings.php line 152
    do_action( 'mc4wp_admin_form_before_behaviour_settings_rows', $opts, $form );
  • includes/forms/views/tabs/form-settings.php line 11
    do_action( 'mc4wp_admin_form_before_mailchimp_settings_rows', $opts, $form );
  • includes/forms/views/tabs/form-messages.php line 10
    do_action( 'mc4wp_admin_form_before_messages_settings_rows', $opts, $form );
  • includes/views/other-settings.php line 95
    do_action( 'mc4wp_admin_other_settings', $opts );
  • includes/forms/class-admin.php line 385
    do_action( 'mc4wp_admin_show_forms_page', $view );
  • includes/forms/class-admin.php line 390
    do_action( "mc4wp_admin_show_forms_page-{$view}" );
  • includes/forms/class-asset-manager.php line 210
    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', ] );
  • includes/integrations/class-integration.php line 324
    do_action( "mc4wp_integration_{$this->slug}_after_checkbox_wrapper", $this );
  • includes/integrations/class-integration.php line 304
    do_action( "mc4wp_integration_{$this->slug}_before_checkbox_wrapper", $this );
  • includes/integrations/class-integration.php line 321
    do_action( 'mc4wp_integration_after_checkbox_wrapper', $this );
  • includes/integrations/class-integration.php line 301
    do_action( 'mc4wp_integration_before_checkbox_wrapper', $this );
  • integrations/gravity-forms/class-field.php line 71
    apply_filters( 'mc4wp_integration_gravity-forms_options', $options );
  • integrations/ninja-forms/class-action.php line 112
    do_action( 'mc4wp_integration_ninja_forms_subscribe', $email_address, $merge_fields, $list_id, $double_optin, $update_existing, $replace_interests, $form_id );
  • includes/forms/class-asset-manager.php line 250
    do_action( 'mc4wp_load_form_scripts' );
  • includes/forms/class-asset-manager.php line 123
    do_action( 'mc4wp_load_form_stylesheets', $stylesheets );
  • includes/api/class-api-v3-client.php line 121
    apply_filters( 'mc4wp_use_sslverify', true );
  • includes/integrations/class-user-integration.php line 46
    apply_filters( 'mc4wp_user_merge_vars', $data, $user );
  • widget_title

    filter
    includes/forms/class-widget.php line 55
    apply_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: