Search Atlas SEO icon
SEO

Search Atlas SEO hooks reference

  • By Search Atlas Group
  • v2.7.7 New
  • Updated

Search Atlas SEO 2.7.7 has 29 actions and 55 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 Search Atlas SEO fires an action
add_action( 'metasync_trigger_immediate_heartbeat', function( $heartbeat_context ) {
	// Your code runs here.
}, 10, 1 );

// Change a value Search Atlas SEO is about to use
add_filter( 'metasync_cpu_detected_cores', function( $detected ) {
	// Change $detected here.
	return $detected;
}, 10, 1 );

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

  • includes/class-metasync-cpu-monitor.php line 127
    /**
     * Filter the detected CPU core count.
     */
    apply_filters( 'metasync_cpu_detected_cores', $detected );
  • media-optimization/class-dimension-injector.php line 380
    /**
     * Hosts whose images may be fetched server-side for dimension sniffing. Empty
     * by default — remote dimension fetching is opt-in, which closes the SSRF
     * surface until a site owner explicitly trusts specific hosts. Checked before
     * any URL parsing so the default (fetch-disabled) path stays cheap.
     */
    apply_filters( 'metasync_dimension_remote_hosts', [] );
  • includes/class-metasync-seo-suite.php line 87
    /**
     * Allow sites to opt out of the unified box and keep the classic separate
     * boxes.
     */
    apply_filters( 'metasync_enable_seo_suite', true, $post_type, $post );
  • includes/class-metasync-mcp-tool-access.php line 292
    /**
     * Filter the read/write classification of a tool.
     */
    apply_filters( 'metasync_mcp_tool_is_read_only', $is_read, $tool_name );
  • otto/class-metasync-otto-backstop-sync.php line 242
    /**
     * Kill switch for the render-path postmeta backstop. Return false to stop
     * MISS-triggered syncs.
     */
    apply_filters( 'metasync_otto_backstop_sync_enabled', true );
  • sitemap/class-metasync-sitemap-generator.php line 244
    /**
     * Filter whether MetaSync manages the XML sitemap URLs.
     */
    apply_filters( 'metasync_sitemap_enabled', $enabled );
  • includes/sitemap-taxonomy-picker.php line 57
    /**
     * Allow integrations to remove additional taxonomies from the picker.
     */
    apply_filters( 'metasync_sitemap_taxonomy_picker_taxonomies', $filtered_taxonomies, $taxonomies );
  • includes/class-metasync-api-key-monitor.php line 278 · used in 8 places
    do_action( 'metasync_trigger_immediate_heartbeat', $heartbeat_context );
  • sitemap/class-metasync-sitemap-generator.php line 817 · used in 3 places
    do_action( 'metasync_sitemap_changed' );
  • the_content

    filter
    includes/class-metasync-html-to-markdown.php line 226 · used in 3 places
    apply_filters( 'the_content', $raw_content );
  • edited_term

    action
    includes/class-metasync-seo-restore.php line 734 · used in 2 places
    do_action( 'edited_term', $term_id, $tt_id, $taxonomy );
  • includes/class-metasync-api-key-monitor.php line 277 · used in 2 places
    do_action( 'metasync_heartbeat_state_key_pending' );
  • includes/class-metasync-opengraph.php line 681 · used in 2 places
    apply_filters( 'metasync_opengraph_check_conflicts', true );
  • admin/class-metasync-seo-sidebar.php line 466 · used in 2 places
    apply_filters( 'metasync_opengraph_will_emit', false );
  • otto/class-metasync-otto-transient-cache.php line 746 · used in 2 places
    apply_filters( 'metasync_otto_circuit_breaker_enabled', true );
  • includes/metasync-helpers.php line 248 · used in 2 places
    apply_filters( 'metasync_sitemap_excluded_post_types', $default_excluded_post_types );
  • includes/class-metasync-cache-purge.php line 441 · used in 2 places
    do_action( 'sg_cachepress_purge_cache' );
  • database/class-db-migrations.php line 906 · used in 2 places
    apply_filters( 'wp_dlct_config_file_manager_path', ABSPATH . 'wp-config.php' );
  • includes/class-metasync-cache-purge.php line 418 · used in 2 places
    do_action( 'wphb_clear_page_cache', $post_id );
  • includes/class-metasync-cache-purge.php line 758
    do_action( 'autoptimize_action_cachepurged' );
  • includes/class-metasync-cache-purge.php line 713
    do_action( 'cache_enabler_clear_complete_cache' );
  • includes/class-metasync-cache-purge.php line 405
    do_action( 'cache_enabler_clear_page_cache_by_url', $url );
  • includes/class-metasync-cache-purge.php line 800
    do_action( 'comet_cache_clear' );
  • otto/metasync-otto-seo-functions.php line 3090
    apply_filters( 'document_title_separator', '-' );
  • includes/class-metasync-edge-cache-purge.php line 592
    do_action( 'fl_clear_all_cache' );
  • includes/class-metasync-otto-cache-manager.php line 832
    apply_filters( 'https_local_ssl_verify', true );
  • includes/class-metasync-cache-purge.php line 582
    do_action( 'litespeed_purge_all' );
  • includes/class-metasync-cache-purge.php line 318
    do_action( 'litespeed_purge_post', $post_id );
  • includes/class-metasync-cache-purge.php line 322
    do_action( 'litespeed_purge_url', $url );
  • wp-mcp-server/tools/class-mcp-tool-db-query.php line 470
    apply_filters( 'mcp_db_query_timeout', $default );
  • includes/class-metasync-admin-navigation.php line 1620
    apply_filters( 'metasync_admin_bar_status_cache_ttl', 5 * MINUTE_IN_SECONDS );
  • includes/class-metasync-api-backoff-manager.php line 236
    do_action( 'metasync_api_backoff_triggered', [ 'endpoint' => $endpoint, 'endpoint_hash' => $endpoint_hash, 'occurrence_count' => $occurrence_count, 'backoff_duration' => $backoff_duration, 'response_code' => $response_code, ] );
  • includes/class-metasync-api-key-monitor.php line 272
    do_action( 'metasync_api_key_changed', $changes, $context, $heartbeat_context );
  • redirections/class-metasync-auto-redirect.php line 306
    do_action( 'metasync_auto_redirect_created', $old_url, $new_url, $post_id );
  • redirections/class-metasync-auto-redirect.php line 63
    apply_filters( 'metasync_auto_redirect_post_types', $this->monitored_post_types );
  • media-optimization/class-media-batch-optimizer.php line 58
    apply_filters( 'metasync_batch_optimize_size', 0 );
  • includes/class-metasync-cpu-monitor.php line 54
    apply_filters( 'metasync_cpu_load_average', $raw[0] );
  • includes/class-metasync-connect-manager.php line 384
    apply_filters( 'metasync_enable_pull_connect', true );
  • public/class-metasync-rest-api.php line 4268
    do_action( 'metasync_ensure_heartbeat_cron_scheduled' );
  • includes/class-metasync-error-logger.php line 177
    do_action( 'metasync_error_logged', $category, $error_code, $message, $full_context );
  • includes/class-metasync-headless-graphql.php line 1162
    apply_filters( 'metasync_headless_graphql_live_refresh', true );
  • includes/class-metasync-headless-refresh-job.php line 323
    apply_filters( 'metasync_headless_refresh_api_timeout', self::DEFAULT_API_TIMEOUT );
  • includes/class-metasync-headless-refresh-job.php line 313
    apply_filters( 'metasync_headless_refresh_batch_size', self::DEFAULT_BATCH_SIZE );
  • includes/class-metasync-headless-refresh-job.php line 265
    apply_filters( 'metasync_headless_refresh_enabled', true );
  • includes/class-metasync-headless-refresh-job.php line 300
    apply_filters( 'metasync_headless_refresh_interval', $seconds );
  • includes/class-metasync-headless-refresh-job.php line 344
    apply_filters( 'metasync_headless_refresh_rate_limit', $default );
  • public/class-metasync-public.php line 245
    apply_filters( 'metasync_load_accordion_assets', $load );
  • wp-mcp-server/class-metasync-mcp-server.php line 1307
    apply_filters( 'metasync_mcp_auth_failure_rate_limit', $defaults, $source );
  • includes/mcp-server-bootstrap.php line 277
    do_action( 'metasync_mcp_register_tools', $server );
  • wp-mcp-server/class-mcp-tool-registry.php line 165
    do_action( 'metasync_mcp_tool_before_execute', $name, $params );
  • wp-mcp-server/class-metasync-mcp-server.php line 297
    apply_filters( 'metasync_mcp_tool_call_rate_limit', $default_limits, $this->authenticated_identity );
  • wp-mcp-server/class-mcp-tool-registry.php line 173
    do_action( 'metasync_mcp_tool_executed', $name, $params, $result, $execution_time );
  • wp-mcp-server/class-mcp-tool-registry.php line 90
    do_action( 'metasync_mcp_tool_registered', $name, $tool );
  • wp-mcp-server/class-mcp-tool-registry.php line 140
    apply_filters( 'metasync_mcp_tools_list', $tools_list );
  • wp-mcp-server/class-metasync-mcp-server.php line 1169
    apply_filters( 'metasync_mcp_trusted_proxies', [] );
  • includes/class-metasync-opengraph.php line 1641
    apply_filters( 'metasync_og_article_post_types', ['post'] );
  • includes/class-metasync-opengraph.php line 2171
    apply_filters( 'metasync_opengraph_post_types', $post_types );
  • otto/class-metasync-otto-transient-cache.php line 208
    apply_filters( 'metasync_otto_api_timeout', self::API_TIMEOUT );
  • otto/otto_pixel.php line 817
    apply_filters( 'metasync_otto_cart_paths', array( 'cart', 'checkout', 'basket', 'request-a-quote', 'quote-request', ) );
  • otto/Otto_html_class.php line 974
    apply_filters( 'metasync_otto_internal_fetch_timeout', 5 );
  • otto/Otto_html_class.php line 955
    apply_filters( 'metasync_otto_internal_fetch_url', $request_body, $route );
  • otto/class-metasync-otto-render-strategy.php line 397
    apply_filters( 'metasync_otto_max_html_bytes', $cap );
  • otto/otto_pixel.php line 975
    apply_filters( 'metasync_otto_skip_on_404', true );
  • otto/otto_pixel.php line 2763
    apply_filters( 'metasync_otto_supported_post_types', $post_types );
  • otto/otto_pixel.php line 2785
    apply_filters( 'metasync_otto_supported_taxonomies', $taxonomies );
  • otto/otto_pixel.php line 3317
    apply_filters( 'metasync_otto_unthrottled_agent', $is_infra, $ua );
  • breadcrumbs/class-metasync-breadcrumbs.php line 68
    apply_filters( 'metasync_override_woocommerce_breadcrumb', false );
  • redirections/class-metasync-redirection.php line 630
    apply_filters( 'metasync_redirect_loop_max_hops', 5 );
  • redirections/class-metasync-redirection-database.php line 291
    do_action( 'metasync_redirections_changed' );
  • includes/class-metasync-admin-navigation.php line 1583
    apply_filters( 'metasync_show_admin_bar_status_frontend', false );
  • sitemap/class-metasync-sitemap-generator.php line 983
    apply_filters( 'metasync_sitemap_chunk_size', 200 );
  • sitemap/class-metasync-sitemap-generator.php line 1506
    apply_filters( 'metasync_sitemap_exclude_redirect_sources', true );
  • includes/metasync-helpers.php line 263
    apply_filters( 'metasync_sitemap_post_types', get_post_types(['public' => true], 'objects') );
  • sitemap/class-metasync-sitemap-generator.php line 1570
    apply_filters( 'metasync_sitemap_rank_math_active', $rank_math_active );
  • sitemap/class-metasync-sitemap-generator.php line 3246
    apply_filters( 'metasync_sitemap_rebuild_retry_pause', 300 );
  • sitemap/class-metasync-sitemap-generator.php line 1040
    apply_filters( 'metasync_sitemap_yoast_redirects_active', defined('WPSEO_VERSION') && defined('WPSEO_PREMIUM_VERSION') );
  • sitemap/class-metasync-sitemap-video.php line 1221
    apply_filters( 'metasync_video_sitemap_thumbnail', $current, $url, $post );
  • sitemap/class-metasync-sitemap-video.php line 933
    apply_filters( 'metasync_video_sitemap_videos_for_post', $videos, $post );
  • includes/class-metasync-cache-purge.php line 566
    do_action( 'rocket_clean_domain' );
  • includes/class-metasync-cache-purge.php line 821
    do_action( 'swift_performance_clear_all_cache' );
  • otto/Otto_pixel_class.php line 707
    do_action( 'wp_enqueue_scripts' );
  • includes/class-metasync-cache-purge.php line 690
    do_action( 'wpfc_clear_all_cache' );
  • includes/class-metasync-cache-purge.php line 393
    do_action( 'wpfc_clear_post_cache_by_url', $url );
  • public/class-metasync-hreflang-output.php line 285
    apply_filters( 'wpml_default_language', null );

Generated from Search Atlas SEO'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: