List of Filters and Actions

This is our list of filters and actions available in MailPoet for use by developers. 

A Filter is a function that can be hooked to an event in WordPress (called hooks).

Need a developer to help you? We recommend those at Codeable (affiliate link).

Filters
mailpoet_api_newsletters_get_after
mailpoet_api_newsletters_save_before
mailpoet_cron_worker_sending_queue_batch_size
mailpoet_display_docsbot_widget
mailpoet_sending_newsletter_render_after

This filter is replaced with mailpoet_sending_newsletter_render_after_pre_process starting from MailPoet 3.98.1
mailpoet_sending_newsletter_render_after_pre_process
mailpoet_mailer_smtp_connection_timeout
mailpoet_mailer_smtp_transport_agent (this filter is replaced with mailpoet_mailer_smtp_option starting from MailPoet 3.89.3)
Sets additional transport options; mostly to modify context options for ssl:// and tls:// transports http://php.net/manual/en/context.ssl.php
This is an example of how to use this filter.
wpmu_registration_enabled
mailpoet_mailer_smtp_host
mailpoet_mailer_smtp_port
mailpoet_mailer_smtp_encryption
mailpoet_mailer_smtp_username
mailpoet_mailer_smtp_password
mailpoet_mailer_smtp_options
mailpoet_mailer_smtp_instance
mailpoet_archive_no_newsletters
mailpoet_archive_title
mailpoet_archive_email_processed_date
mailpoet_archive_email_subject_line
mailpoet_rendering_post_process
mailpoet_newsletter_shortcode_link

Creates custom link shortcode that's rendered when newsletter is sent/previewed. 
mailpoet_newsletter_shortcode

Creates custom shortcode that's rendered when newsletter is sent/previewed. 
mailpoet_conflict_resolver_whitelist_style

Prevents third-party plugin's JS or CSS dependencies from being unloaded. 
mailpoet_form_widget_post_process

Sets rendered form body before output. Used to modify form parameters (e.g., setting form's  target to something other than self)

mailpoet_newsletter_post_excerpt_length

Sets custom post excerpt size. Used when fetching posts inside Editor (ALC or regular Post block) or during rendering. 
mailpoet_permission_access_plugin_admin

Sets permission to view MailPoet/Mailpoet → Help/MailPoet → Premium/MailPoet → Welcome/MailPoet → Update pages. 
mailpoet_permission_manage_settings

Sets permission to view MailPoet → Settings. 
mailpoet_permission_manage_emails

Sets permission to view MailPoet → Emails. 
mailpoet_permission_manage_subscribers

Sets permission to view MailPoet → Subscribers. 
mailpoet_permission_manage_forms

Sets permission to view MailPoet → Forms. 
mailpoet_permission_manage_segments

Sets permission to view MailPoet → Segments. 
mailpoet_permission_update_plugin

Sets permission to activate/deactivate plugin. 
mailpoet_cron_request_url

Overrides default URL used to access the plugin in the background 
mailpoet_cron_request_args

Overrides default arguments used by https://codex.wordpress.org/Function_Reference/wp_remote_get
mailpoet_subscription_before_subscribe

Action, which fires before a subscription is stored in the database. You can use this action to intercept the subscription being stored by throwing an UnexcpectedValueException. Example:
add_action(
	'mailpoet_subscription_before_subscribe',
	function($data, $segmentIds, $form) {
		if ($form->id() !== 10 || !in_array(21, $segmentIds)) {
			return;
		}
		
		
		if ($data['some_custom_field'] === 'wrong') {
			throw new \MailPoet\UnexpectedValueException("You can not use 'wrong' in the some_custom_field.");
		}
	},
	10,
	3
);
		
mailpoet_subscription_limit_enabled

Enables/disables IP throttling in subscription form. Expects a boolean. Example: add_filter('mailpoet_subscription_limit_enabled', '__return_false');

mailpoet_subscription_limit_window

Overrides throttling window (IP addresses memory span). Default: DAY_IN_SECONDS

mailpoet_subscription_limit_base

Overrides throttling base timeout (the first one that gets doubled every time). Default:  MINUTE_IN_SECONDS

mailpoet_segments_with_subscriber_count

Add dynamic segments on newsletters and subscribers page. 

mailpoet_get_subscribers_in_segment_finders

Enables hooking a finder which can find subscribers in a dynamic segment. 

mailpoet_get_subscribers_listings_in_segment_handlers

Loads listings handlers for subscribers in a dynamic segment. 

mailpoet_subscribers_listings_filters_segments

Loads dynamic segment for subscribers filter.

mailpoet_transient_cache_enabled

A boolean to enable the transient cache for MailPoet. Default is true.

mailpoet_bridge_api_request_timeout

Sets timeout for Bridge API HTTP requests.  Useful on slow hosts where connection times out on large HTTP requests. 

mailpoet_search_terms_args

Update search terms arguments. Useful for sites with a lot of tags to prioritise categories in search. 


mailpoet_manage_subscription_page_form_fields 

Customize form fields displayed on the Manage Subscription page. The argument is an array of fields and their properties.

mailpoet_manage_subscription_page

Customize the template of the Manage Subscription page. The argument is a rendered HTML code of the page to be displayed. 

mailpoet_unsubscribe_confirmation_page 

Change confirmation sentence. The URL to confirm unsubscribing is sent as a 2nd parameter to the filter.


mailpoet_display_custom_fonts 

Disable Google Fonts to stop loading it.


mailpoet_display_form_supported_post_types

Add a custom post type where forms should be displayed.


mailpoet_display_form_in_product_listing

Set whether forms should be displayed on Shop page / product listings (default to `true`)


mailpoet_re_captcha_size

It can be either normal or compact (docs).

Actions
mailpoet_initialized
mailpoet_api_setup
mailpoet_setup_reset
mailpoet_api_newsletters_duplicate_after 
mailpoet_api_newsletters_save_after
mailpoet_conflict_resolver_styles
mailpoet_conflict_resolver_scripts
mailpoet_conflict_resolver_router_url_query_parameters
mailpoet_subscriber_created
mailpoet_subscriber_updated

mailpoet_subscriber_deleted
mailpoet_multiple_subscribers_created
mailpoet_multiple_subscribers_updated
mailpoet_multiple_subscribers_deleted


MailPoet Premium

Filters
mailpoet_newsletters_before_router
mailpoet_newsletters_listing_stats_before
mailpoet_newsletters_listings_standard_actions
mailpoet_newsletters_listings_welcome_notification_actions
mailpoet_newsletters_listings_notification_history_actions
mailpoet_newsletters_3rd_step_fields
mailpoet_newsletters_types
mailpoet_newsletters_before_router
mailpoet_newsletters_listings_welcome_notification_actions
mailpoet_api_newsletters_save_before
mailpoet_api_newsletters_get_after
mailpoet_sending_newsletter_render_after
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.