CrawlWP SEO 3.1.2 has 32 actions and 111 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.
// Run your own code when CrawlWP SEO fires an action
add_action( 'crawlwp/post_updated', function( $ID, $post ) {
// Your code runs here.
}, 10, 2 );
// Change a value CrawlWP SEO is about to use
add_filter( 'crawlwp_robots_directives', function( $directives, $entity_key ) {
// Change $directives here.
return $directives;
}, 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
-
/** * Filter the robots directives for the current request. */ apply_filters( 'crawlwp_robots_directives', $directives, $entity_key ); -
/** * Filter the HTML appended to each RSS feed item. */ apply_filters( 'crawlwp_rss_content_after', $after, get_post() ); -
/** * Filter the HTML prepended to each RSS feed item. */ apply_filters( 'crawlwp_rss_content_before', $before, get_post() ); -
/** * This filter is documented below in the singular branch. */ apply_filters( 'crawlwp_schema_data', $schema, null ); -
/** * Trigger the same action the plugin fires when a post is updated, so all * registered IndexNow providers will ping the URL. */ do_action( 'crawlwp/post_updated', $post->ID, $post ); -
/** * Filter the query arg name used for passing the chain ID to new processes. */ apply_filters( "{$this->identifier}_chain_id_arg_name", self::CHAIN_ID_ARG_NAME ); -
/** * Filters the post arguments used during an async request. */ apply_filters( "{$this->identifier}_post_args", $args ); -
/** * Filter fired before background process dispatches its next process. */ apply_filters( "{$this->identifier}_pre_dispatch", false, $this->get_chain_id() ); -
/** * Action to note whether the background process managed to create its lock. */ do_action( "{$this->identifier}_process_locked", $locked, $microtime, $lock_duration, $this->get_chain_id() ); -
/** * Action to note whether the background process managed to release its lock. */ do_action( "{$this->identifier}_process_unlocked", $unlocked, $this->get_chain_id() ); -
/** * Filters the query arguments used during an async request. */ apply_filters( "{$this->identifier}_query_args", $args ); -
/** * Filters the query URL used during an async request. */ apply_filters( "{$this->identifier}_query_url", $url ); -
/** * Number of seconds to sleep between batches. Defaults to 0 seconds, minimum * 0. */ apply_filters( "{$this->identifier}_seconds_between_batches", apply_filters( $this->prefix . '_seconds_between_batches', 0 ) ); -
/** * Filter whether the current background process should continue running the * task if there is data to be processed. */ apply_filters( "{$this->identifier}_should_continue", ! ( $this->time_exceeded() || $this->memory_exceeded() || $this->is_paused() || $this->is_cancelled() ), $this->get_chain_id() ); -
/** * Should wp_die be used? */ apply_filters( "{$this->identifier}_wp_die", true ); -
/** * Number of seconds to sleep between batches. Defaults to 0 seconds, minimum * 0. */ apply_filters( "{$this->prefix}_seconds_between_batches", 0 ); -
/** * Filters the body of the 410 Gone / 451 Unavailable page. */ apply_filters( "crawlwp_{$code}_message", $default_message, $post_id ); -
/** * Filters the title of the 410 Gone / 451 Unavailable page. */ apply_filters( "crawlwp_{$code}_title", $heading, $post_id ); -
/** * Filters the maximum number of 404 log rows kept (0 = unlimited). */ apply_filters( 'crawlwp_404_max_rows', self::DEFAULT_MAX_ROWS ); -
/** * Filters how many days of 404 log entries are kept (0 = forever). */ apply_filters( 'crawlwp_404_retention_days', $days ); -
/** * Filter accessible post types for CrawlWP SEO notifications. */ apply_filters( 'crawlwp_accessible_post_types', $post_types ); -
/** * Filter the new post type notification message template. */ apply_filters( 'crawlwp_admin_notice_new_post_type', $message, $count ); -
/** * Filter the cleaned content sent to the provider. */ apply_filters( 'crawlwp_ai_content', $content, $post_id ); -
/** * Filter the share of the cap taken from the top of long content. */ apply_filters( 'crawlwp_ai_content_head_ratio', self::CONTENT_HEAD_RATIO, $post_id, $max ); -
/** * Filter the AI-generated SEO text. */ apply_filters( 'crawlwp_ai_generate_seo', '', $field, $context ); -
/** * Filter the generated text before it is returned to the editor. */ apply_filters( 'crawlwp_ai_generated_text', $clean, $field, $context ); -
/** * Filter the language the generated text must be written in. */ apply_filters( 'crawlwp_ai_language', $language, $post_id, $locale ); -
/** * Filter the maximum number of content characters sent to the provider. */ apply_filters( 'crawlwp_ai_max_content_chars', self::MAX_CONTENT_CHARS, $post_id ); -
/** * Filter the user prompt sent to the AI provider. */ apply_filters( 'crawlwp_ai_prompt', $prompt, $field, [ 'post_id' => $post_id, 'title' => $title, 'content' => $content, 'keyword' => $keyword, 'previous' => $previous, 'language' => $language, ] ); -
/** * Filter the system instruction sent to the AI provider. */ apply_filters( 'crawlwp_ai_system_instruction', $system, $field, $language ); -
/** * Filters whether the current user may store a redirect to an external host. */ apply_filters( 'crawlwp_allow_external_redirects', current_user_can('manage_options'), $post_id ); -
/** * Filters whether to auto-create a redirect for this permalink change. */ apply_filters( 'crawlwp_auto_redirect_permalink_change', true, $old_url, $new_url, $post_id ); -
/** * Filter the final rendered breadcrumb HTML. */ apply_filters( 'crawlwp_breadcrumbs_html', $output, $links, $this->args ); -
/** * Filter the taxonomy used for the breadcrumb term on a single post. */ apply_filters( 'crawlwp_breadcrumbs_post_taxonomy', $taxonomy, $post ); -
/** * Filters the HTML allowed inside the breadcrumb separator. */ apply_filters( 'crawlwp_breadcrumbs_separator_allowed_html', $allowed ); -
/** * Filters whether the "missing title/description" filters also match legacy * posts that have no meta row at all. */ apply_filters( 'crawlwp_bulk_editor_legacy_missing_fallback', true, $key ); -
/** * Filter the canonical URL for the current request. */ apply_filters( 'crawlwp_canonical_url', $canonical, $entity_key, $context ); -
/** * Filter the hreflang alternates for the current request. */ apply_filters( 'crawlwp_hreflang_links', [], $data ); -
/** * Filters how long the inbound link list of a post stays cached. */ apply_filters( 'crawlwp_inbound_links_cache_ttl', 15 * MINUTE_IN_SECONDS, $post_id ); -
/** * Filters the URL legacy SEO-plugin sitemap addresses redirect to. */ apply_filters( 'crawlwp_legacy_sitemap_redirect', $target, $relative ); -
/** * Filter the resolved meta description for the current request. */ apply_filters( 'crawlwp_meta_description', $description, $entity_key, $context ); -
/** * Filter the resolved meta title for the current request. */ apply_filters( 'crawlwp_meta_title', $title, $entity_key, $context ); -
/** * Fires after the SEO metabox assets are enqueued, so add-on plugins can * enqueue their own scripts/styles for the metabox (e.g. an extra tab). */ do_action( 'crawlwp_metabox_enqueue_assets', $hook ); -
/** * Let add-on plugins (e.g. mihdan-index-now-pro) inject extra data into the * metabox's localized `crawlwpSEO` object — nonces, feature flags, etc. — * without this plugin needing to know about them. */ apply_filters( 'crawlwp_metabox_localize_data', $localize_data, $post ); -
/** * Fires after the last built-in SEO metabox panel ("Advanced"). */ do_action( 'crawlwp_metabox_panels', $post, $data ); -
/** * Fires inside the SEO metabox tab bar, right after the "Advanced" tab. */ do_action( 'crawlwp_metabox_tabs', $post, $data ); -
/** * Filter the Open Graph meta tags array before output. */ apply_filters( 'crawlwp_open_graph_tags', $og_tags, $data ); -
/** * Filter the calculated SEO score for a post. */ apply_filters( 'crawlwp_post_seo_score', $score, $post_id ); -
/** * Filter the SEO signals shown for a post in the list table. */ apply_filters( 'crawlwp_post_seo_signals', $signals, $post ); -
/** * Filter the ID of a page that stands in for a post type archive, e.g. the * WooCommerce "Shop" page. Its per-page SEO values win over the archive * templates, which stay the fallback. */ apply_filters( 'crawlwp_post_type_archive_page_id', 0, $post_type->name ); -
/** * Filters the hosts CrawlWP may redirect to. */ apply_filters( 'crawlwp_redirect_allowed_hosts', [] ); -
/** * Filters the body shown for a 410 / 451 redirect rule. */ apply_filters( 'crawlwp_redirect_gone_message', $default, $type, $redirect ); -
/** * Filters the page title shown for a 410 / 451 redirect rule. */ apply_filters( 'crawlwp_redirect_gone_title', $title, $type, $redirect ); -
/** * Filters the action hook used to process redirects. */ apply_filters( 'crawlwp_redirect_hook', 'wp' ); -
/** * Filters the priority of the redirect processing action hook. */ apply_filters( 'crawlwp_redirect_priority', -1 ); -
/** * Fires when a redirect rule is automatically disabled at runtime. */ do_action( 'crawlwp_redirect_rule_auto_disabled', $id, $reason, $pattern ); -
/** * Allow third parties to resolve custom variables. */ apply_filters( 'crawlwp_resolve_title_variable', '', $token, $this->context ); -
/** * Filter the saved robots.txt content before it is output. */ apply_filters( 'crawlwp_robots_txt', $content, $public ); -
/** * Filter the HTML allowed in the RSS before/after content templates. */ apply_filters( 'crawlwp_rss_allowed_html', $allowed ); -
/** * Filter every JSON-LD node collected for the current request. */ apply_filters( 'crawlwp_schema_graph', self::get_nodes() ); -
/** * Filter the notice ids the dismiss endpoint accepts. */ apply_filters( 'crawlwp_seo_notice_ids', self::NOTICE_IDS ); -
/** * Filter the list of critical SEO notices before display. */ apply_filters( 'crawlwp_seo_notices', $notices ); -
/** * Filters whether the SEO signals may be served from the post meta cache. */ apply_filters( 'crawlwp_seo_signals_cache_enabled', true, $post ); -
/** * Filter the site graph before it is handed to the request graph. */ apply_filters( 'crawlwp_site_graph', $graph ); -
/** * Filter where the site verification meta tags are printed. */ apply_filters( 'crawlwp_site_verification_scope', self::SCOPE_FRONT_PAGE ); -
/** * Filter the IDs of posts that are kept out of every sitemap. */ apply_filters( 'crawlwp_sitemap_excluded_post_ids', [] ); -
/** * Fires every time the sitemap settings are saved, even when no value changed. * Cached sitemaps hook this to flush themselves. */ do_action( 'crawlwp_sitemap_settings_saved' ); -
/** * Filter the fully resolved template string (after all token substitutions, * before separator cleanup). */ apply_filters( 'crawlwp_template_resolved', (string) $output, $template, $this->context ); -
/** * Filter the entities that receive global title & meta defaults. */ apply_filters( 'crawlwp_title_meta_entities', $entities ); -
/** * Filter a stored title & meta default. */ apply_filters( 'crawlwp_title_meta_option', $value, $entity_key, $field ); -
/** * Filter the post types shown in the Title & Meta settings. */ apply_filters( 'crawlwp_title_meta_post_types', $post_types ); -
/** * Filter the taxonomies shown in the Title & Meta settings. */ apply_filters( 'crawlwp_title_meta_taxonomies', $taxonomies ); -
/** * Filter the variables advertised in the settings UI. */ apply_filters( 'crawlwp_title_meta_variables', $definitions ); -
/** * Filter the title separator used by the {{ sep }} variable. */ apply_filters( 'crawlwp_title_separator', $separator ); -
/** * Filter how long the preview samples stay cached. */ apply_filters( 'crawlwp_tm_samples_cache_ttl', self::SAMPLES_TTL ); -
/** * Filters whether logged-in users are excluded from the GA4 / GTM tags. */ apply_filters( 'crawlwp_tracking_exclude_logged_in', false ); -
/** * Filter the X/Twitter card meta tags array before output. */ apply_filters( 'crawlwp_twitter_card_tags', $twitter_tags, $data ); -
/** * Filter the value resolved for a single template variable. */ apply_filters( 'crawlwp_variable_resolved', $value, $token, $this->context ); -
/** * Filter the Product node printed on single product pages. */ apply_filters( 'crawlwp_woocommerce_product_schema', $node, $product ); -
/** * Filters whether CrawlWP replaces WooCommerce's native Product structured * data with its own. */ apply_filters( 'crawlwp_woocommerce_schema_enabled', true ); -
/** * Filter why a post is not submitted for indexing. Return an empty string to * allow it. */ apply_filters( 'crawlwp/post_skip_reason', $reason, $post instanceof WP_Post ? $post : null ); -
/** * Filter dismiss-notice.js URL. */ apply_filters( 'pand_dismiss_notice_js_url', $js_url, $composer_path ); -
/** * Filter to activate another filter providing a simpler use case. */ apply_filters( 'pand_theme_loader', \false ); -
apply_filters( 'wposa/get_option', $options[$option], $option, $section, $default ); -
do_action( 'crawlwp/index_pinged', 'post', $post_id ); -
apply_filters( 'wp_sitemaps_stylesheet_content', $xsl_content ); -
apply_filters( 'crawlwp_ai_rate_limit_window', 5 * MINUTE_IN_SECONDS ); -
apply_filters( 'crawlwp_seo_features_is_enabled', self::$cache ); -
apply_filters( 'crawlwp_woocommerce_noindex_account_pages', true ); -
do_action( 'crawlwp/term_updated', (int) $term_id, (string) $taxonomy ); -
apply_filters( 'wpml_post_language_details', null, $post_id ); -
do_action( "{$is_update?}crawlwp/post_updated{:}crawlwp/post_added", $post->ID, $post ); -
do_action( "{$this->identifier}_cancelled", $this->get_chain_id() ); -
do_action( "{$this->identifier}_completed", $this->get_chain_id() ); -
apply_filters( "{$this->identifier}_default_time_limit", 20 ); -
apply_filters( "{$this->identifier}_memory_exceeded", $return ); -
do_action( "{$this->identifier}_paused", $this->get_chain_id() ); -
apply_filters( "{$this->identifier}_queue_lock_time", $lock_duration ); -
do_action( "{$this->identifier}_resumed", $this->get_chain_id() ); -
apply_filters( "{$this->identifier}_time_exceeded", $return ); -
do_action( 'crawlwp_after_advanced_settings_fields', $wposa ); -
do_action( 'crawlwp_after_title_meta_settings_fields', $wposa ); -
apply_filters( 'crawlwp_ai_rate_limit', 20 ); -
apply_filters( 'crawlwp_alternate_cron_runner', $this->is_alternate_cron_runner ); -
do_action( 'crawlwp_before_advanced_settings_fields', $wposa ); -
do_action( 'crawlwp_before_title_meta_settings_fields', $wposa ); -
apply_filters( 'crawlwp_bg_process_batches_upper_limit', 20 ); -
apply_filters( 'crawlwp_breadcrumbs_args', $this->args ); -
apply_filters( 'crawlwp_breadcrumbs_enabled', $enabled ); -
apply_filters( 'crawlwp_breadcrumbs_links', $this->links ); -
apply_filters( 'crawlwp_is_pro_active', defined('CRAWLWP_DETACH_LIBSODIUM') ); -
do_action( 'crawlwp_lite_before_init' ); -
apply_filters( 'crawlwp_normalized_new_url', defined('CRAWLWP_URL') ? CRAWLWP_URL : '' ); -
do_action( 'crawlwp_pre_setup_fields', $this->wposa, $this ); -
apply_filters( 'crawlwp_redirect_before_insert', $this->sanitize($data) ); -
apply_filters( 'crawlwp_redirect_before_update', $this->sanitize($data), $id ); -
apply_filters( 'crawlwp_seo_meta_box_context', 'normal' ); -
apply_filters( 'crawlwp_seo_meta_box_priority', $priority ); -
do_action( 'crawlwp_setup_fields', $this->wposa, $this ); -
do_action( 'crawlwp_setup_fields_after_title_meta', $wposa, $this ); -
do_action( 'crawlwp_setup_fields_before_log', $this->wposa, $this ); -
apply_filters( "crawlwp_sitemap_{$normalized}_stylesheet_url", $url ); -
apply_filters( 'crawlwp_sitemap_stylesheet_url', $url, $normalized ); -
apply_filters( 'crawlwp_sitemaps_custom_stylesheet_content', $xsl_content ); -
apply_filters( 'crawlwp_sitemaps_news_stylesheet_content', $xsl_content ); -
apply_filters( 'crawlwp_sitemaps_stylesheet_css', $css . $extra ); -
apply_filters( 'crawlwp_sitemaps_video_stylesheet_content', $xsl_content ); -
do_action( 'crawlwp/bg_process_task', $action, $item, $this ); -
do_action( 'crawlwp/comment_updated', $post->ID, $comment ); -
apply_filters( 'crawlwp/host', wp_parse_url(Utils::normalized_home_url(), PHP_URL_HOST) ); -
do_action( 'crawlwp/index_removal_pinged', 'post', $post_id, $permalink ); -
do_action( 'crawlwp/init', $this ); -
do_action( 'crawlwp/post_deleted', $post->ID, $permalink ); -
apply_filters( 'crawlwp/post_types', array_filter((array)self::get_option('post_types', 'general')) ); -
apply_filters( 'crawlwp/taxonomies', array_filter((array)self::get_option('taxonomies', 'general')) ); -
apply_filters( 'crawlwp/term_skip_reason', $reason, $term instanceof WP_Term ? $term : null ); -
apply_filters( 'https_local_ssl_verify', false ); -
apply_filters( 'robots_txt', $output, true ); -
apply_filters( 'wpml_object_id', $post_id, 'any', false, $target_language ); -
apply_filters( 'wposa_submitted_data', $posted_data, $name, $_POST ); -
do_action( "wsa_form_bottom_{$form['id']}", $form ); -
do_action( "wsa_form_top_{$form['id']}", $form );
Generated from CrawlWP SEO's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Done for you
Rather have it built for you?
Tell us what should change and we’ll write and test the code using these hooks.
Custom hook snippet
from $49
A small, update-safe change built on the plugin’s own hooks.
- Code written against the plugin’s actions and filters
- Tested on a staging copy of your site
- Install instructions included
Typical turnaround: 2–3 business days
Choose thisPlugin customisation
from $149
New features or changed behaviour, without editing the plugin’s files.
- Built as a companion plugin, so updates never wipe it
- Exact quote before we start
- Tested on staging, then deployed
Typical turnaround: 3–7 business days
Choose thisNot sure which fits? Describe what you need and we’ll suggest the simplest option.
Can't find the right hook?
We can build the customisation for you. Describe what you need: