Kit (formerly ConvertKit) icon
Email & Marketing

Kit (formerly ConvertKit) hooks reference

  • By Kit
  • v3.5.2 New
  • Updated

Kit (formerly ConvertKit) 3.5.2 has 30 actions and 66 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 Kit (formerly ConvertKit) fires an action
add_action( 'convertkit_settings_base_render_after', function() {
	// Your code runs here.
}, 10, 1 );

// Change a value Kit (formerly ConvertKit) is about to use
add_filter( 'convertkit_output_restrict_content_content_preview', function( $value, $ID ) {
	// Change $value here.
	return $value;
}, 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

  • admin/section/class-convertkit-admin-section-base.php line 264 · used in 4 places
    /**
     * Performs actions after rendering of the settings form.
     */
    do_action( 'convertkit_settings_base_render_after' );
  • admin/section/class-convertkit-admin-section-base.php line 249 · used in 4 places
    /**
     * Performs actions prior to rendering the settings form.
     */
    do_action( 'convertkit_settings_base_render_before' );
  • includes/class-convertkit-output-restrict-content.php line 852 · used in 3 places
    /**
     * Define the output for the content preview when the visitor is not an
     * authenticated subscriber.
     */
    apply_filters( 'convertkit_output_restrict_content_content_preview', $this->get_content_preview( $content ), $post->ID );
  • includes/blocks/class-convertkit-block-broadcasts.php line 616 · used in 2 places
    /**
     * Filter the block's content immediately before it is output.
     */
    apply_filters( 'convertkit_block_broadcasts_render', $html, $atts );
  • includes/pre-publish-actions/class-convertkit-pre-publish-action.php line 154 · used in 2 places
    /**
     * Run this pre-publish action, as the WordPress Post has just transitioned to
     * publish from another state.
     */
    do_action( "convertkit_pre_publish_action_run_{$this->get_name()}", $post );
  • includes/functions.php line 348
    /**
     * Registers abilities for the Kit Plugin.
     */
    apply_filters( 'convertkit_abilities', $abilities );
  • admin/class-convertkit-admin-category.php line 63
    /**
     * Enqueue JavaScript when editing a Category that outputs ConvertKit Plugin
     * settings.
     */
    do_action( 'convertkit_admin_category_enqueue_scripts' );
  • admin/class-convertkit-admin-category.php line 97
    /**
     * Enqueue CSS when editing a Category that outputs ConvertKit Plugin settings.
     */
    do_action( 'convertkit_admin_category_enqueue_styles' );
  • includes/class-convertkit-gutenberg.php line 183
    /**
     * Adds block categories to the default Gutenberg Block Categories
     */
    apply_filters( 'convertkit_admin_gutenberg_add_block_categories', $categories, $post );
  • includes/class-convertkit-admin-notices.php line 87
    /**
     * Define the text to output in an admin error notice.
     */
    apply_filters( "convertkit_admin_notices_output_{$notice}", $output );
  • admin/class-convertkit-admin-post.php line 118
    /**
     * Enqueue JavaScript when editing a Page, Post or Custom Post Type that
     * outputs ConvertKit Plugin settings.
     */
    do_action( 'convertkit_admin_post_enqueue_scripts' );
  • admin/class-convertkit-admin-post.php line 144
    /**
     * Enqueue CSS for the Settings Screen at Settings > Kit
     */
    do_action( 'convertkit_admin_post_enqueue_styles' );
  • admin/class-convertkit-admin-post.php line 69
    /**
     * Registers 'Add New' buttons for the given Post Type's admin screen.
     */
    apply_filters( 'convertkit_admin_post_register_add_new_buttons', $buttons, $post_type );
  • admin/class-convertkit-admin-settings.php line 70
    /**
     * Enqueue JavaScript for the Settings Screen at Settings > Kit
     */
    do_action( 'convertkit_admin_settings_enqueue_scripts', $section );
  • admin/class-convertkit-admin-settings.php line 101
    /**
     * Enqueue CSS for the Settings Screen at Settings > Kit
     */
    do_action( 'convertkit_admin_settings_enqueue_styles', $section );
  • admin/class-convertkit-admin-settings.php line 172
    /**
     * Defines the settings form's action URL.
     */
    apply_filters( 'convertkit_admin_settings_form_action_url', admin_url( 'options.php' ), $active_section );
  • admin/class-convertkit-admin-settings.php line 162
    /**
     * Defines the settings form's method.
     */
    apply_filters( 'convertkit_admin_settings_form_method', 'post', $active_section );
  • admin/class-convertkit-admin-settings.php line 367
    /**
     * Registers settings sections at Settings > Kit.
     */
    apply_filters( 'convertkit_admin_settings_register_sections', $sections );
  • admin/class-convertkit-admin-setup-wizard.php line 352
    /**
     * Load any data into class variables for the given setup wizard name and
     * current step.
     */
    do_action( "convertkit_admin_setup_wizard_load_screen_data_{$this->page_name}", $this->step );
  • admin/class-convertkit-admin-setup-wizard.php line 289
    /**
     * Process submitted form data for the given setup wizard name and current
     * step.
     */
    do_action( "convertkit_admin_setup_wizard_process_form_{$this->page_name}", $this->step );
  • admin/class-convertkit-admin-setup-wizard.php line 189
    /**
     * Define the steps for the setup wizard.
     */
    apply_filters( "convertkit_admin_setup_wizard_steps_{$this->page_name}", $this->steps );
  • includes/blocks/class-convertkit-block-broadcasts.php line 861
    /**
     * Defines the HTML for an individual broadcast item in the Broadcasts block.
     */
    apply_filters( 'convertkit_block_broadcasts_build_html_list_item', $html, $broadcast, $atts );
  • includes/blocks/class-convertkit-block-broadcasts.php line 679
    /**
     * Filter the block's inner content immediately before it is output by AJAX,
     * which occurs when pagination was clicked.
     */
    apply_filters( 'convertkit_block_broadcasts_render_ajax', $html, $atts );
  • includes/blocks/class-convertkit-block-content.php line 322
    /**
     * Filters the content in the ConvertKit Custom Content block/shortcode
     * immediately before it is output.
     */
    apply_filters( 'convertkit_block_content_render', $content, $atts, $subscriber_id, $tags, $tag );
  • includes/blocks/class-convertkit-block-form-builder-field.php line 340
    /**
     * Filter the block's content immediately before it is output.
     */
    apply_filters( 'convertkit_block_form_builder_field_render', $html, $atts );
  • includes/blocks/class-convertkit-block-form-builder.php line 770
    /**
     * Filter the block's content immediately before it is output.
     */
    apply_filters( 'convertkit_block_form_builder_render', $html, $atts );
  • includes/blocks/class-convertkit-block-form.php line 488
    /**
     * Filter the block's content immediately before it is output.
     */
    apply_filters( 'convertkit_block_form_render', $form, $atts, $form_id );
  • includes/blocks/class-convertkit-block-form-trigger.php line 399
    /**
     * Filter the block's content immediately before it is output.
     */
    apply_filters( 'convertkit_block_form_trigger_render', $html, $atts );
  • includes/blocks/class-convertkit-block-member-content-login.php line 393
    /**
     * Filter the block's content immediately before it is output.
     */
    apply_filters( 'convertkit_block_member_content_login_render', $html, $atts );
  • includes/blocks/class-convertkit-block-product.php line 455
    /**
     * Filter the block's content immediately before it is output.
     */
    apply_filters( 'convertkit_block_product_render', $html, $atts );
  • includes/functions.php line 227
    /**
     * Registers blocks for the ConvertKit Plugin.
     */
    apply_filters( 'convertkit_blocks', $blocks );
  • includes/class-convertkit-broadcasts-importer.php line 348
    /**
     * Define the wp_insert_post() compatible arguments for importing a ConvertKit
     * Broadcast to a new WordPress Post.
     */
    apply_filters( 'convertkit_broadcasts_build_post_args', $post_args, $broadcast );
  • includes/class-convertkit-broadcasts-exporter.php line 333
    /**
     * Define the preview text for the Broadcast created from the WordPress Post.
     */
    apply_filters( 'convertkit_broadcasts_exporter_preview_text', $preview_text, $post );
  • includes/class-convertkit-broadcasts-importer.php line 502
    /**
     * Parses the given Broadcast's content, removing unnecessary HTML tags and
     * styles.
     */
    apply_filters( 'convertkit_broadcasts_parse_broadcast_content', $content, $post_id, $broadcast_content, $broadcast_title, $import_images, $disable_styles );
  • includes/class-convertkit-broadcasts-importer.php line 606
    /**
     * Define the HTML tags to retain in the Broadcast Content.
     */
    apply_filters( 'convertkit_broadcasts_parse_broadcast_content_permitted_html_tags', $permitted_html_tags );
  • includes/integrations/contactform7/class-convertkit-contactform7-settings.php line 150
    /**
     * The default settings, used when Contact Form 7's Settings haven't been saved
     * e.g. on a new installation or when the Contact Form 7 Plugin has just been
     * activated for the first time.
     */
    apply_filters( 'convertkit_contactform7_settings_get_defaults', $defaults );
  • includes/blocks/helpers/class-convertkit-content-post-helper.php line 280
    /**
     * Filters the detected page builder for a Post.
     */
    apply_filters( 'convertkit_content_post_helper_detect_page_builder', false, $post_id );
  • includes/integrations/forminator/class-convertkit-forminator-settings.php line 154
    /**
     * The default settings, used when Forminator's Settings haven't been saved
     * e.g. on a new installation or when the Forminator Plugin has just been
     * activated for the first time.
     */
    apply_filters( 'convertkit_forminator_settings_get_defaults', $defaults );
  • includes/class-convertkit-output.php line 414
    /**
     * Filter the Post's Content, which includes a ConvertKit Form, immediately
     * before it is output.
     */
    apply_filters( 'convertkit_frontend_append_form', $content, $form, $post_id, $form_id, $form_position );
  • includes/functions.php line 251
    /**
     * Registers block formatters in Gutenberg for the ConvertKit Plugin.
     */
    apply_filters( 'convertkit_get_block_formatters', $block_formatters );
  • includes/functions.php line 324
    /**
     * Registers form importers for the ConvertKit Plugin.
     */
    apply_filters( 'convertkit_get_form_importers', $importers );
  • includes/functions.php line 299
    /**
     * Registers pre-publish actions for the ConvertKit Plugin.
     */
    apply_filters( 'convertkit_get_pre_publish_actions', $pre_publish_actions );
  • includes/functions.php line 144
    /**
     * Defines the Post Types that support ConvertKit Forms.
     */
    apply_filters( 'convertkit_get_supported_post_types', $post_types );
  • includes/class-convertkit-gutenberg.php line 336
    /**
     * Determine the block API version to use for registering blocks.
     */
    apply_filters( 'convertkit_gutenberg_block_api_version', $block_api_version );
  • includes/class-convertkit-gutenberg.php line 402
    /**
     * Enqueue any additional scripts for Gutenberg blocks that have been
     * registered.
     */
    do_action( 'convertkit_gutenberg_enqueue_scripts', $blocks, $block_formatters );
  • includes/class-convertkit-gutenberg.php line 450
    /**
     * Enqueues scripts for Gutenberg blocks in both the editor and frontend view,
     * if the Plugin's Disable JavaScript option is not enabled.
     */
    do_action( 'convertkit_gutenberg_enqueue_scripts_editor_and_frontend' );
  • includes/class-convertkit-gutenberg.php line 426
    /**
     * Enqueue styles for Gutenberg blocks that have been registered.
     */
    do_action( 'convertkit_gutenberg_enqueue_styles' );
  • includes/class-convertkit-gutenberg.php line 474
    /**
     * Enqueues styles for Gutenberg blocks in both the editor and frontend view,
     * if the Plugin's Disable CSS option is not enabled.
     */
    do_action( 'convertkit_gutenberg_enqueue_styles_editor_and_frontend' );
  • includes/class-wp-convertkit.php line 107
    /**
     * Initialize integration classes for the WordPress Administration interface.
     */
    do_action( 'convertkit_initialize_admin' );
  • includes/class-wp-convertkit.php line 128
    /**
     * Initialize integration classes for the WordPress Administration interface or
     * a frontend Page Builder.
     */
    do_action( 'convertkit_initialize_admin_or_frontend_editor' );
  • includes/class-wp-convertkit.php line 149
    /**
     * Initialize integration classes for WP-CLI and WP-Cron.
     */
    do_action( 'convertkit_initialize_cli_cron' );
  • includes/class-wp-convertkit.php line 174
    /**
     * Initialize integration classes for the frontend web site.
     */
    do_action( 'convertkit_initialize_frontend' );
  • includes/class-wp-convertkit.php line 222
    /**
     * Initialize integration classes for the frontend web site.
     */
    do_action( 'convertkit_initialize_global' );
  • includes/class-wp-convertkit.php line 342
    /**
     * Filters whether the current request is a WordPress Administration / Frontend
     * Editor request or not.
     */
    apply_filters( 'convertkit_is_admin_or_frontend_editor', $is_admin_or_frontend_editor );
  • includes/class-convertkit-output.php line 303
    /**
     * Define the ConvertKit Form ID to display for the given Post ID, overriding
     * the Post, Category or Plugin settings.
     */
    apply_filters( 'convertkit_output_append_form_to_content_form_id', $form_id, $post_id );
  • includes/class-convertkit-output.php line 259
    /**
     * Perform any actions immediately prior to outputting the Landing Page.
     */
    do_action( 'convertkit_output_landing_page_before', $landing_page, $landing_page_id, $post_id );
  • includes/class-convertkit-output.php line 178
    /**
     * Outputs a ConvertKit Form on singular Post Types that don't use
     * the_content() or apply_filters( 'the_content' ).
     */
    do_action( 'convertkit_output_output_form' );
  • includes/class-convertkit-output.php line 223
    /**
     * Define the ConvertKit Landing Page ID to display for the given Post ID,
     * overriding the Post settings.
     */
    apply_filters( 'convertkit_output_page_takeover_landing_page_id', $landing_page_id, $post_id );
  • includes/class-convertkit-output-restrict-content.php line 1870
    /**
     * Define the output for the call to action, displayed below the content
     * preview, when the visitor is not an authenticated subscriber.
     */
    apply_filters( 'convertkit_output_restrict_content_call_to_action', $call_to_action, $this->post_id );
  • includes/class-convertkit-output-restrict-content.php line 1883
    /**
     * Define the container CSS classes to wrap the content preview and call to
     * action within.
     */
    apply_filters( 'convertkit_output_restrict_content_container_css_classes', $container_css_classes, $this->post_id );
  • includes/class-convertkit-output-restrict-content.php line 1631
    /**
     * Define the ConvertKit Resource ID that the visitor must be subscribed
     * against to access this content, overriding the Post setting.
     */
    apply_filters( 'convertkit_output_restrict_content_get_resource_id', $resource_id, $this->post_id );
  • includes/class-convertkit-output-restrict-content.php line 1593
    /**
     * Define the ConvertKit Resource Type that the visitor must be subscribed
     * against to access this content, overriding the Post setting.
     */
    apply_filters( 'convertkit_output_restrict_content_get_resource_type', $resource_type, $this->post_id );
  • includes/class-convertkit-output-restrict-content.php line 2580
    /**
     * Define the permitted user agents and their IP address ranges that can bypass
     * Restrict Content to index content for search engines.
     */
    apply_filters( 'convertkit_output_restrict_content_is_crawler_permitted_user_agent_ip_ranges', $permitted_user_agent_ip_ranges );
  • includes/functions.php line 275
    /**
     * Registers plugin sidebars for the WordPress block editor.
     */
    apply_filters( 'convertkit_plugin_sidebars', $plugin_sidebars );
  • includes/class-convertkit-post.php line 354
    /**
     * The default settings, used to populate the Post's Settings when a Post has
     * no Settings.
     */
    apply_filters( 'convertkit_post_get_default_settings', $defaults, $this->post_id );
  • includes/class-convertkit-post.php line 86
    /**
     * Programmatically define ConvertKit settings for an individual Post,
     * overriding those defined in the meta box.
     */
    apply_filters( 'convertkit_post_settings', $meta, $this->post_id );
  • includes/functions.php line 396
    /**
     * Registers MCP prompts for the Kit Plugin.
     */
    apply_filters( 'convertkit_prompts', $prompts );
  • includes/class-convertkit-resource-forms.php line 695
    /**
     * Filter the form <script> key/value pairs immediately before the script is
     * output.
     */
    apply_filters( 'convertkit_resource_forms_output_script', $script );
  • includes/class-convertkit-resource-account.php line 109
    /**
     * Perform any actions immediately after the resource has been refreshed.
     */
    do_action( "convertkit_resource_refreshed_{$this->type}", $results );
  • includes/functions.php line 372
    /**
     * Registers MCP resources for the Kit Plugin.
     */
    apply_filters( 'convertkit_resources', $resources );
  • includes/class-convertkit-output-restrict-content.php line 776
    /**
     * Allow specific Themes and Page Builders to use a different filter for
     * Restrict Content functionality.
     */
    do_action( 'convertkit_restrict_content_register_content_filter' );
  • admin/section/class-convertkit-admin-section-base.php line 214
    /**
     * Register success and error notices for settings screens.
     */
    apply_filters( 'convertkit_settings_base_register_notices', $notices );
  • admin/section/class-convertkit-admin-section-base.php line 1006
    /**
     * Performs actions prior to settings being saved.
     */
    do_action( 'convertkit_settings_base_sanitize_settings', $this->name, $updated_settings );
  • includes/class-convertkit-settings-broadcasts.php line 422
    /**
     * The default settings, used when the ConvertKit Broadcasts Settings haven't
     * been saved e.g. on a new installation.
     */
    apply_filters( 'convertkit_settings_broadcasts_get_defaults', $defaults );
  • includes/class-convertkit-settings.php line 875
    /**
     * The default settings, used when the ConvertKit Plugin Settings haven't been
     * saved e.g. on a new installation.
     */
    apply_filters( 'convertkit_settings_get_defaults', $defaults );
  • includes/class-convertkit-settings-mcp.php line 110
    /**
     * The default settings, used when the ConvertKit MCP Settings haven't been
     * saved e.g. on a new installation.
     */
    apply_filters( 'convertkit_settings_mcp_get_defaults', $defaults );
  • includes/class-convertkit-settings-restrict-content.php line 278
    /**
     * The default settings, used when the ConvertKit Restrict Content Settings
     * haven't been saved e.g. on a new installation.
     */
    apply_filters( 'convertkit_settings_restrict_content_get_defaults', $defaults );
  • includes/functions.php line 203
    /**
     * Registers shortcodes for the ConvertKit Plugin.
     */
    apply_filters( 'convertkit_shortcodes', $shortcodes );
  • includes/class-convertkit-subscriber.php line 275
    /**
     * Whether to use a numeric subscriber ID that couldn't be verified, either
     * from a request without a matching `sh_kit` parameter, or from a cookie
     * without a valid signature.
     */
    apply_filters( 'convertkit_subscriber_allow_unverified_id', false, $subscriber_id );
  • includes/class-convertkit-term.php line 199
    /**
     * The default settings, used to populate the Term's Settings when a Term has
     * no Settings.
     */
    apply_filters( 'convertkit_term_get_default_settings', $defaults );
  • includes/class-convertkit-user.php line 108
    /**
     * The default settings, used to populate the User's Settings when a User has
     * no Settings.
     */
    apply_filters( 'convertkit_user_get_default_settings', $defaults );
  • includes/integrations/wishlist/class-convertkit-wishlist-settings.php line 150
    /**
     * The default settings, used when WishList's Settings haven't been saved e.g.
     * on a new installation or when the WishList Plugin has just been activated
     * for the first time.
     */
    apply_filters( 'convertkit_wishlist_settings_get_defaults', $defaults );
  • includes/blocks/class-convertkit-block-form.php line 498
    /**
     * Backward compat. filter for < 1.9.6. Filter the block's content immediately
     * before it is output.
     */
    apply_filters( 'wp_convertkit_get_form_embed', $form, $atts );
  • includes/blocks/class-convertkit-block-content.php line 333
    /**
     * Backward compat. filter for < 1.9.6. Filters the content in the ConvertKit
     * Custom Content block/shortcode immediately before it is output.
     */
    apply_filters( 'wp_convertkit_shortcode_custom_content', $content, $atts );
  • the_content

    filter
    includes/class-convertkit-broadcasts-exporter.php line 243 · used in 3 places
    apply_filters( 'the_content', $post->post_content );
  • includes/class-convertkit-output-restrict-content.php line 1031 · used in 2 places
    apply_filters( 'excerpt_length', 55 );
  • admin/class-convertkit-admin-setup-wizard.php line 404
    do_action( 'admin_enqueue_scripts' );
  • admin_head

    action
    views/backend/setup-wizard/header.php line 22
    do_action( 'admin_head' );
  • views/backend/setup-wizard/header.php line 20
    do_action( 'admin_print_scripts' );
  • views/backend/setup-wizard/header.php line 21
    do_action( 'admin_print_styles' );
  • excerpt_more

    filter
    includes/class-convertkit-output-restrict-content.php line 1144
    apply_filters( 'excerpt_more', ' […]' );

Generated from Kit (formerly ConvertKit)'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: