Hatch Hooks and Filters for Developers

By the end of this page you will know the hatch_* filters Hatch Connect applies and where they hook in, so you can adjust behaviour from a small plugin or your theme’s functions file.

Filters

• hatch_revalidate_post_types the post types that trigger a frontend refresh. Default: post and page.
• hatch_content_html the content HTML Hatch sends to the frontend.
• hatch_form_rate_limit rate limit for headless form submissions. Default: 10.
• hatch_form_max_body_bytes maximum size of a form submission body. Default: 64 KB.
• hatch_form_retention_days how long stored form submissions are kept. Default: 90 days.
• hatch_turnstile_fail_open whether a Turnstile check may pass when Turnstile cannot be verified. Default: true.
• hatch_plugin_bridge_catalog the catalog of plugin bridges Hatch knows about.
• hatch_seo_internal_url internal URLs in SEO output.
• hatch_sync_wp_layout whether Hatch pins its content width on your theme’s containers. Default: off (set by the hatch_sync_wp_layout option).
• hatch_url_rewriter_needed whether the URL rewriter is needed.
• hatch_diagnostic_include_webhook_check whether the diagnostic includes the webhook check. Default: off.
• hatch_deploy_providers the list of deploy providers.
• hatch_cloudflare_api_root the Cloudflare API base URL. Default: https://api.cloudflare.com/client/v4.
• hatch_dynamic_block_names the block names treated as dynamic when Hatch serialises a post’s blocks. Add names for blocks that render on the server.

Example: refresh a custom post type

1. Create a small plugin or open your child theme’s functions.php.
2. Add the filter below.
3. Publish a product and check the Status tab for the refresh time.

add_filter( 'hatch_revalidate_post_types', function ( $types ) {
    $types[] = 'product';
    return $types;
} );

WordPress core hooks Hatch respects

Frontend sign-up runs WordPress’s own register_post, registration_errors, illegal_user_logins and register_new_user hooks, and sign-in fires wp_login, so security plugins keep working.

What to do next

• Hatch endpoints reference
• WP-CLI commands
• The hatch/v1 REST bridge