WordPress filter hook · part of WordPress core
document_title_separator
A WordPress core filter that 67 plugins also fire themselves, running on 4.8M+ sites between them.
“Filters the separator for the document title.”
How to use document_title_separator
It's a filter: your callback receives the value, and must return the (changed) value.
Add this to your theme's functions.php or a small custom plugin:
add_filter( 'document_title_separator', function( $sep ) {
// Change $sep here.
return $sep;
}, 10, 1 );Argument names come from Parsi Date's source. Other plugins may pass different values: check the call in the plugin you're targeting below.
This hook is fired by WordPress core too. Official reference on developer.wordpress.org →
67 plugins that fire document_title_separator
Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.
-
Jetpack3+ million installs
apply_filters( 'document_title_separator', '-' )jetpack_vendor/automattic/jetpack-seo/src/class-dashboard-data.php:1291 -
Fluent Forms800,000+ installs
apply_filters( 'document_title_separator', '-' )app/Modules/Payments/PaymentMethods/BaseProcessor.php:512 -
The Events Calendar600,000+ installs
apply_filters( 'document_title_separator', '-' )src/Tribe/Template_Factory.php:265 -
Parsi Date100,000+ installs
apply_filters( 'document_title_separator', $sep )inc/App/Core/FixTitle.php:50 -
BuddyPress90,000+ installs
apply_filters( 'document_title_separator', '-' )bp-core/bp-core-filters.php:778 -
Slim SEO70,000+ installs
apply_filters( 'document_title_separator', '-' )src/MetaTags/Helper.php:44 -
AMP for WP70,000+ installs
apply_filters( 'document_title_separator', '-' )includes/features/opengraph.php:218 -
PowerPress Podcasting plugin by Blubrry20,000+ installs
apply_filters( 'document_title_separator', '-' )powerpress.php:544 -
ThinkRank SEO20,000+ installs
apply_filters( 'document_title_separator', self::SEPARATOR )includes/admin/importers/class-slim-seo-exporter.php:983 -
Ecwid by Lightspeed Ecommerce Shopping Cart20,000+ installs
apply_filters( 'document_title_separator', '|' )ecwid-shopping-cart.php:1124 -
GeoDirectory10,000+ installs
apply_filters( 'document_title_separator', $sep )includes/class-geodir-seo.php:916 -
LifterLMS10,000+ installs
apply_filters( 'document_title_separator', '-' )includes/class.llms.student.dashboard.php:410 -
Welcart e-Commerce10,000+ installs
apply_filters( 'document_title_separator', '|' )functions/filters.php:523 -
Secure MCP Server for Claude, ChatGPT, Gemini, Cursor and other AI Agents10,000+ installs
apply_filters( 'document_title_separator', '-' )libraries/abilities/src/packs/seo/class-seo-core-reader.php:77 -
Search Atlas SEO6,000+ installs
apply_filters( 'document_title_separator', '-' )otto/metasync-otto-seo-functions.php:3090 -
WP Job Manager2,000+ installs
apply_filters( 'document_title_separator', '-' )wp-job-manager-companies.php:322 -
SEOKEY1,000+ installs
apply_filters( 'document_title_separator', '-' )public/modules/meta-title.php:97 -
Flexmls® IDX Plugin1,000+ installs
apply_filters( 'document_title_separator', '-' )pages/listing-details.php:1078 -
Visibility700+ installs
apply_filters( 'document_title_separator', '-' )includes/class-title-template.php:454 -
Nota400+ installs
apply_filters( 'document_title_separator', '-' )includes/class-nota-post-tools.php:461 -
Web Directory plugin Free300+ installs
apply_filters( 'document_title_separator', '-' )directory/directory_seo.php:316 -
SEOS300+ installs
apply_filters( 'document_title_separator', '-' )includes/class-seos-audit.php:252 -
Prime SEO100+ installs
apply_filters( 'document_title_separator', '–' )public/class-prime-seo-public.php:74 -
RW Elephant Rental Inventory70+ installs
apply_filters( 'document_title_separator', '-' )lib/helpers.php:681 -
Sky SEO50+ installs
apply_filters( 'document_title_separator', '-' )src/Frontend/Head.php:167 -
SEOYEN SEO Platform40+ installs
apply_filters( 'document_title_separator', '-' )includes/class-seoyen-site-seo.php:841 -
Publishio30+ installs
apply_filters( 'document_title_separator', '-' )inc/Modules/MCP/Apps/Preview/Page_Details.php:117 -
MCP Connector for wp2ai20+ installs
apply_filters( 'document_title_separator', '-' )includes/class-wp2ai-rest-api.php:15555 -
Theme Site Kit20+ installs
apply_filters( 'document_title_separator', '-' )includes/class-kwtsk-maintenance-mode.php:554 -
SlugMaster20+ installs
apply_filters( 'document_title_separator', '-' )includes/class-router.php:424 -
Kads SEO10+ installs
apply_filters( 'document_title_separator', '-' )includes/class-kseo-seo.php:1971 -
KUMITATE Site Tools10+ installs
apply_filters( 'document_title_separator', '-' )includes/seo-meta.php:22 -
KBucket: Your Curated Content in WordPress10+ installs
apply_filters( 'document_title_separator', '-' )include/kb_single.php:598 -
ProRank SEO10+ installs
apply_filters( 'document_title_separator', '-' )includes/Frontend/HeadOutput.php:512 -
Dozent LMS10+ installs
apply_filters( 'document_title_separator', '-' )core/Query.php:72 -
AuditAE10+ installs
apply_filters( 'document_title_separator', '-' )includes/seo-meta.php:692 -
Ultimate Crypto Widget10+ installs
apply_filters( 'document_title_separator', '–' )lib/wptoolkit/src/Frontend/PublicPages.php:272 -
PaginovaFewer than 10 installs
apply_filters( 'document_title_separator', '-' )classes/class-pchap-seo.php:378 -
STS SEOFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/metadata.php:259 -
Beplus Metadata AI AnalyzerFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/class-sso-meta-box.php:1158 -
Just TranslateFewer than 10 installs
apply_filters( 'document_title_separator', "\u{2013}" )modules/jt-translator.php:47 -
BinaryPH AI SEOFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/class-bps-native-output.php:211 -
SyncRankerFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/class-dynamic-schema.php:79 -
Arcadys Municipal CoreFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/seo.php:657 -
RankRush.aiFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/seo/editor-box.php:91 -
SnippetDeskFewer than 10 installs
apply_filters( 'document_title_separator', '-' )src/Adapters/RankMathAdapter.php:513 -
ARN Smart AI-Powered Site Utilities for ElementorFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/class-arnsmesu-meta.php:289 -
Meta Description and SEO Title RewriterFewer than 10 installs
apply_filters( 'document_title_separator', '-' )inc/kollen.php:469 -
CitedBy SEO FieldsFewer than 10 installs
apply_filters( 'document_title_separator', '-' )citedby-seo-fields.php:280 -
NexaBoardFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/class-nexaboard-frontend.php:594 -
User Dashboard For Easy Digital DownloadsFewer than 10 installs
apply_filters( 'document_title_separator', ' - ' )admin/dashboard/dashboard-functions.php:197 -
AlmaSEO SEO PlaygroundFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/import/import-mapper-slimseo.php:99 -
Valhalla for VikingerFewer than 10 installs
apply_filters( 'document_title_separator', '-' )modules/safety/module.php:1281 -
ConvoceptFewer than 10 installs
apply_filters( 'document_title_separator', '-' )src/Subscriptions/ManagePage.php:200 -
Contentrain BridgeFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/class-contentrain-bridge-seo-render.php:288 -
WP Job Manager CompaniesFewer than 10 installs
apply_filters( 'document_title_separator', '-' )wp-job-manager-companies-polylang.php:328 -
FXOapps Product Filter for WooCommerceFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/class-frontend.php:844 -
Leitvia Studio: AI Agents, MCP and Design Tokens for Block ThemesFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/gateway/abilities/class-seo.php:439 -
Rox Hotel BookingFewer than 10 installs
apply_filters( 'document_title_separator', '-' )src/Modules/Seo/Services/SeoHead.php:315 -
LogviaFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/class-logvia-frontend.php:195 -
WPMMCC ATSFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/hooks/class-virtual-site-seo.php:960 -
Digispot AIFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/audit/class-preview-source.php:539 -
Hydrogen SEOFewer than 10 installs
apply_filters( 'document_title_separator', '-' )inc/modules/migration/sources/slim-seo/source.php:106 -
RankHiveFewer than 10 installs
apply_filters( 'document_title_separator', '-' )src/SeoCheck/SeoMetaResolver.php:416 -
Marzipan Commerce for WineriesFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/class-marzipan-seo.php:292 -
Schema GuruFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/functions.php:385 -
Smart Woo Service InvoicingFewer than 10 installs
apply_filters( 'document_title_separator', '-' )includes/sw-functions.php:1125
Need a customisation built on this hook?
Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.