WPInterface SEO 1.0.2 has 12 actions and 50 filters, read directly from its source code on Nov 19, 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 WPInterface SEO fires an action
add_action( 'wpiseo_admin_enqueue_scripts', function( $arg1 ) {
// Your code runs here.
}, 10, 1 );
// Change a value WPInterface SEO is about to use
add_filter( 'wpiseo_translate_string', function( $text, $arg2 ) {
// Change $text here.
return $text;
}, 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
-
/** * This filter is documented in src/Templates/Parser.php */ apply_filters( 'wpiseo_translate_string', $text, 'breadcrumbs' ); -
/** * Filters the maximum number of focus keywords per post. */ apply_filters( 'wpiseo_max_focus_keywords', self::MAX_KEYWORDS ); -
/** * Filters the plugin's abilities before registration. */ apply_filters( 'wpiseo_abilities', $definitions ); -
/** * Fires after the admin app is enqueued on one of the plugin's pages. Add-ons * enqueue their page scripts here (depend on `wpiseo-admin`). */ do_action( 'wpiseo_admin_enqueue_scripts', $this->current_page_id() ); -
/** * Filters the admin pages under the SEO menu. */ apply_filters( 'wpiseo_admin_pages', $pages ); -
/** * Filters the plugin's branding. */ apply_filters( 'wpiseo_branding', $defaults ); -
/** * Filters the breadcrumb items. */ apply_filters( 'wpiseo_breadcrumb_items', $this->items, $context ); -
/** * Filters the breadcrumb HTML. The result is passed through wp_kses() with * allowed_html(). */ apply_filters( 'wpiseo_breadcrumbs_html', $html, $items, $context ); -
/** * Filters the canonical URL ('' prints none). */ apply_filters( 'wpiseo_canonical', $canonical, $this->context ); -
/** * Fires after the classic editor metabox saved its fields. Add-ons save their * own `_wpiseo_*` meta from `$data`, whose keys have the `_wpiseo_` prefix * removed. Known fields are sanitized by their field spec, other strings with * sanitize_textarea_field(); validate them further for your own format. */ do_action( 'wpiseo_classic_meta_saved', (int) $post_id, $data ); -
/** * Filters the detected conflicting SEO plugins. */ apply_filters( 'wpiseo_conflicting_plugins', $active ); -
/** * Filters the resolved context of the current request. */ apply_filters( 'wpiseo_context', Context::from_query( $wp_the_query ), $wp_the_query ); -
/** * Filters the plugin's cron hooks, cleared on deactivation and uninstall. */ apply_filters( 'wpiseo_cron_hooks', array( 'wpiseo_daily', 'wpiseo_hourly', 'wpiseo_batch', 'wpiseo_indexnow_flush', 'wpiseo_links_rebuild', 'wpiseo_gsc_sync' ) ); -
/** * Filters whether a meta key may be printed via %custom_field()%. Protected * (underscore-prefixed) keys are refused by default because the output is * public. */ apply_filters( 'wpiseo_custom_field_allowed', '' !== $key && ! is_protected_meta( $key, 'post' ), $key, $context ); -
/** * Filters the dashboard's next steps. Each item: id, severity * (critical|warning|notice), title, help and action { label, url }. They are * sorted by severity afterwards; items of equal severity keep their order. */ apply_filters( 'wpiseo_dashboard_insights', $insights, $stats ); -
/** * Filters the dashboard figures before they are cached. Add-ons add their own * keys here and turn them into next steps with the `wpiseo_dashboard_insights` * filter. Store numbers, not text: the result is shared by every user. */ apply_filters( 'wpiseo_dashboard_stats', $stats ); -
/** * Filters the figures in the "SEO overview" Dashboard widget. */ apply_filters( 'wpiseo_dashboard_widget_tiles', $tiles, $stats ); -
/** * Filters which roles receive plugin capabilities on install. */ apply_filters( 'wpiseo_default_role_capabilities', array( 'administrator' => self::all(), 'editor' => array( self::EDIT_SEO, self::VIEW_ANALYTICS ), 'author' => array( self::EDIT_SEO ), 'contributor' => array( self::EDIT_SEO ), ) ); -
/** * Filters the default settings. */ apply_filters( 'wpiseo_default_settings', $defaults ); -
/** * Filters the meta description. */ apply_filters( 'wpiseo_description', $description, $this->context ); -
/** * Filters the editor app configuration. */ apply_filters( 'wpiseo_editor_config', $config, $post ); -
/** * Fires after the SEO editor app is enqueued. Add-ons enqueue editor scripts * here (depend on `wpiseo-editor`). */ do_action( 'wpiseo_editor_enqueue_scripts', $post, $mode ); -
/** * Filters the post types that show the SEO panel. */ apply_filters( 'wpiseo_editor_post_types', $post_types ); -
/** * Filters the Search Console token broker URL. */ apply_filters( 'wpiseo_gsc_broker_url', $url ); -
/** * Filters the seconds one sync step may run. */ apply_filters( 'wpiseo_gsc_sync_time_limit', 20 ); -
/** * Fires inside the plugin's `<head>` block. Social and schema output hook * here. */ do_action( 'wpiseo_head', $presentation ); -
/** * Filters importers (ID => Importer). */ apply_filters( 'wpiseo_importers', $importers ); -
/** * Fires once the plugin has registered its hooks. */ do_action( 'wpiseo_loaded', $this ); -
/** * Filters whether a 404 is logged. */ apply_filters( 'wpiseo_log_404', true, $url ); -
/** * Filters module definitions. Add-ons (e.g. Pro) register modules here. */ apply_filters( 'wpiseo_module_definitions', ModuleDefinitions::all() ); -
/** * Filters whether a module is enabled. */ apply_filters( 'wpiseo_module_enabled', $enabled, $id ); -
/** * Filters module labels: ID => label, description, requires_label (optional). */ apply_filters( 'wpiseo_module_labels', $labels ); -
/** * Fires after enabled modules registered their hooks. */ do_action( 'wpiseo_modules_loaded', $this->instances ); -
/** * Filters the Open Graph image. */ apply_filters( 'wpiseo_og_image', $image, $this->context ); -
/** * Filters whether the plugin prints front-end SEO output. */ apply_filters( 'wpiseo_output_enabled', $enabled ); -
/** * Filters a rendered template. */ apply_filters( 'wpiseo_parsed_template', $this->cleanup( (string) $output ), $template, $context ); -
/** * Filters the fallback primary term when none was chosen. */ apply_filters( 'wpiseo_primary_term_fallback', $terms[0], $post, $taxonomy, $terms ); -
/** * Filters the matched rule (null for none). */ apply_filters( 'wpiseo_redirect_match', $this->repository->match( $request ), $request ); -
/** * Fires after redirect rules changed. */ do_action( 'wpiseo_redirects_changed' ); -
/** * Lets modules and third parties register template variables. */ do_action( 'wpiseo_register_variables', $registry ); -
/** * Filters robots directives. */ apply_filters( 'wpiseo_robots', $robots, $this->context ); -
/** * Filters settings before they are saved. Modules sanitize their own sections * here. */ apply_filters( 'wpiseo_sanitize_settings', $settings, $defaults ); -
/** * Filters one graph node before it is added. Return null to drop it. */ apply_filters( "wpiseo_schema_{$piece}", $node, $this->presentation ); -
/** * Filters the complete list of graph nodes. */ apply_filters( 'wpiseo_schema_graph', array_values( $graph ), $this->presentation ); -
/** * Fires after settings were saved. */ do_action( 'wpiseo_settings_updated', $clean, $values ); -
/** * Filters whether the plugin shows pointers to WPInterface SEO Pro. Return * false to remove them all, e.g. on client sites. */ apply_filters( 'wpiseo_show_upsell', $enabled ); -
/** * Filters a post's sitemap entry. Return null to skip the post. */ apply_filters( 'wpiseo_sitemap_post_entry', $entry, $post ); -
/** * Filters the query used to list a post type in the sitemap. */ apply_filters( 'wpiseo_sitemap_post_query_args', $args, $this->post_type ); -
/** * Filters sitemap providers (name => Provider). */ apply_filters( 'wpiseo_sitemap_providers', $providers ); -
/** * Filters a term's sitemap entry. Return null to skip the term. */ apply_filters( 'wpiseo_sitemap_term_entry', $entry, $term ); -
/** * Filters the query used to list a taxonomy in the sitemap. */ apply_filters( 'wpiseo_sitemap_term_query_args', $args, $this->taxonomy ); -
/** * Filters the videos listed for a post in the video sitemap. */ apply_filters( 'wpiseo_sitemap_videos', array_slice( $videos, 0, 20 ), $post ); -
/** * Filters social meta tags before output. */ apply_filters( 'wpiseo_social_tags', $tags, $presentation ); -
/** * Filters the SEO title. */ apply_filters( 'wpiseo_title', $title, $this->context ); -
/** * Fires after the plugin database was upgraded. */ do_action( 'wpiseo_upgraded', $from, WPISEO_DB_VERSION ); -
apply_filters( 'wpml_object_id', $post->ID, $post->post_type, false, $code ); -
apply_filters( 'wpml_active_languages', null, array( 'skip_missing' => 0 ) ); -
apply_filters( 'wpml_default_language', null ); -
apply_filters( 'wpml_permalink', $url, $language, true ); -
do_action( 'wpml_register_single_string', self::CONTEXT, self::name( $text ), $text ); -
do_action( 'wpml_switch_language', 'all' ); -
apply_filters( 'wpml_translate_single_string', $text, self::CONTEXT, self::name( $text ) );
Generated from WPInterface 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: