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:

functions.php
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.

  1. Jetpack icon Jetpack3+ million installs apply_filters( 'document_title_separator', '-' ) jetpack_vendor/automattic/jetpack-seo/src/class-dashboard-data.php:1291
  2. Fluent Forms icon Fluent Forms800,000+ installs apply_filters( 'document_title_separator', '-' ) app/Modules/Payments/PaymentMethods/BaseProcessor.php:512
  3. The Events Calendar icon The Events Calendar600,000+ installs apply_filters( 'document_title_separator', '-' ) src/Tribe/Template_Factory.php:265
  4. Parsi Date icon Parsi Date100,000+ installs apply_filters( 'document_title_separator', $sep ) inc/App/Core/FixTitle.php:50
  5. BuddyPress icon BuddyPress90,000+ installs apply_filters( 'document_title_separator', '-' ) bp-core/bp-core-filters.php:778
  6. Slim SEO icon Slim SEO70,000+ installs apply_filters( 'document_title_separator', '-' ) src/MetaTags/Helper.php:44
  7. AMP for WP icon AMP for WP70,000+ installs apply_filters( 'document_title_separator', '-' ) includes/features/opengraph.php:218
  8. PowerPress Podcasting plugin by Blubrry icon PowerPress Podcasting plugin by Blubrry20,000+ installs apply_filters( 'document_title_separator', '-' ) powerpress.php:544
  9. ThinkRank SEO icon ThinkRank SEO20,000+ installs apply_filters( 'document_title_separator', self::SEPARATOR ) includes/admin/importers/class-slim-seo-exporter.php:983
  10. Ecwid by Lightspeed Ecommerce Shopping Cart icon Ecwid by Lightspeed Ecommerce Shopping Cart20,000+ installs apply_filters( 'document_title_separator', '|' ) ecwid-shopping-cart.php:1124
  11. GeoDirectory icon GeoDirectory10,000+ installs apply_filters( 'document_title_separator', $sep ) includes/class-geodir-seo.php:916
  12. LifterLMS icon LifterLMS10,000+ installs apply_filters( 'document_title_separator', '-' ) includes/class.llms.student.dashboard.php:410
  13. Welcart e-Commerce icon Welcart e-Commerce10,000+ installs apply_filters( 'document_title_separator', '|' ) functions/filters.php:523
  14. Secure MCP Server for Claude, ChatGPT, Gemini, Cursor and other AI Agents icon 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
  15. Search Atlas SEO icon Search Atlas SEO6,000+ installs apply_filters( 'document_title_separator', '-' ) otto/metasync-otto-seo-functions.php:3090
  16. WP Job Manager icon WP Job Manager2,000+ installs apply_filters( 'document_title_separator', '-' ) wp-job-manager-companies.php:322
  17. SEOKEY icon SEOKEY1,000+ installs apply_filters( 'document_title_separator', '-' ) public/modules/meta-title.php:97
  18. Flexmls® IDX Plugin icon Flexmls® IDX Plugin1,000+ installs apply_filters( 'document_title_separator', '-' ) pages/listing-details.php:1078
  19. Visibility icon Visibility700+ installs apply_filters( 'document_title_separator', '-' ) includes/class-title-template.php:454
  20. Nota icon Nota400+ installs apply_filters( 'document_title_separator', '-' ) includes/class-nota-post-tools.php:461
  21. Web Directory plugin Free icon Web Directory plugin Free300+ installs apply_filters( 'document_title_separator', '-' ) directory/directory_seo.php:316
  22. SEOS icon SEOS300+ installs apply_filters( 'document_title_separator', '-' ) includes/class-seos-audit.php:252
  23. Prime SEO icon Prime SEO100+ installs apply_filters( 'document_title_separator', '–' ) public/class-prime-seo-public.php:74
  24. RW Elephant Rental Inventory icon RW Elephant Rental Inventory70+ installs apply_filters( 'document_title_separator', '-' ) lib/helpers.php:681
  25. Sky SEO icon Sky SEO50+ installs apply_filters( 'document_title_separator', '-' ) src/Frontend/Head.php:167
  26. SEOYEN SEO Platform icon SEOYEN SEO Platform40+ installs apply_filters( 'document_title_separator', '-' ) includes/class-seoyen-site-seo.php:841
  27. Publishio icon Publishio30+ installs apply_filters( 'document_title_separator', '-' ) inc/Modules/MCP/Apps/Preview/Page_Details.php:117
  28. MCP Connector for wp2ai icon MCP Connector for wp2ai20+ installs apply_filters( 'document_title_separator', '-' ) includes/class-wp2ai-rest-api.php:15555
  29. Theme Site Kit icon Theme Site Kit20+ installs apply_filters( 'document_title_separator', '-' ) includes/class-kwtsk-maintenance-mode.php:554
  30. SlugMaster icon SlugMaster20+ installs apply_filters( 'document_title_separator', '-' ) includes/class-router.php:424
  31. Kads SEO icon Kads SEO10+ installs apply_filters( 'document_title_separator', '-' ) includes/class-kseo-seo.php:1971
  32. KUMITATE Site Tools icon KUMITATE Site Tools10+ installs apply_filters( 'document_title_separator', '-' ) includes/seo-meta.php:22
  33. KBucket: Your Curated Content in WordPress icon KBucket: Your Curated Content in WordPress10+ installs apply_filters( 'document_title_separator', '-' ) include/kb_single.php:598
  34. ProRank SEO icon ProRank SEO10+ installs apply_filters( 'document_title_separator', '-' ) includes/Frontend/HeadOutput.php:512
  35. Dozent LMS icon Dozent LMS10+ installs apply_filters( 'document_title_separator', '-' ) core/Query.php:72
  36. AuditAE icon AuditAE10+ installs apply_filters( 'document_title_separator', '-' ) includes/seo-meta.php:692
  37. Ultimate Crypto Widget icon Ultimate Crypto Widget10+ installs apply_filters( 'document_title_separator', '–' ) lib/wptoolkit/src/Frontend/PublicPages.php:272
  38. Paginova icon PaginovaFewer than 10 installs apply_filters( 'document_title_separator', '-' ) classes/class-pchap-seo.php:378
  39. STS SEO icon STS SEOFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/metadata.php:259
  40. Beplus Metadata AI Analyzer icon Beplus Metadata AI AnalyzerFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/class-sso-meta-box.php:1158
  41. Just Translate icon Just TranslateFewer than 10 installs apply_filters( 'document_title_separator', "\u{2013}" ) modules/jt-translator.php:47
  42. BinaryPH AI SEO icon BinaryPH AI SEOFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/class-bps-native-output.php:211
  43. SyncRanker icon SyncRankerFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/class-dynamic-schema.php:79
  44. Arcadys Municipal Core icon Arcadys Municipal CoreFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/seo.php:657
  45. RankRush.ai icon RankRush.aiFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/seo/editor-box.php:91
  46. SnippetDesk icon SnippetDeskFewer than 10 installs apply_filters( 'document_title_separator', '-' ) src/Adapters/RankMathAdapter.php:513
  47. ARN Smart AI-Powered Site Utilities for Elementor icon ARN Smart AI-Powered Site Utilities for ElementorFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/class-arnsmesu-meta.php:289
  48. Meta Description and SEO Title Rewriter icon Meta Description and SEO Title RewriterFewer than 10 installs apply_filters( 'document_title_separator', '-' ) inc/kollen.php:469
  49. CitedBy SEO Fields icon CitedBy SEO FieldsFewer than 10 installs apply_filters( 'document_title_separator', '-' ) citedby-seo-fields.php:280
  50. NexaBoard icon NexaBoardFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/class-nexaboard-frontend.php:594
  51. User Dashboard For Easy Digital Downloads icon User Dashboard For Easy Digital DownloadsFewer than 10 installs apply_filters( 'document_title_separator', ' - ' ) admin/dashboard/dashboard-functions.php:197
  52. AlmaSEO SEO Playground icon AlmaSEO SEO PlaygroundFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/import/import-mapper-slimseo.php:99
  53. Valhalla for Vikinger icon Valhalla for VikingerFewer than 10 installs apply_filters( 'document_title_separator', '-' ) modules/safety/module.php:1281
  54. Convocept icon ConvoceptFewer than 10 installs apply_filters( 'document_title_separator', '-' ) src/Subscriptions/ManagePage.php:200
  55. Contentrain Bridge icon Contentrain BridgeFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/class-contentrain-bridge-seo-render.php:288
  56. WP Job Manager Companies icon WP Job Manager CompaniesFewer than 10 installs apply_filters( 'document_title_separator', '-' ) wp-job-manager-companies-polylang.php:328
  57. FXOapps Product Filter for WooCommerce icon FXOapps Product Filter for WooCommerceFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/class-frontend.php:844
  58. Leitvia Studio: AI Agents, MCP and Design Tokens for Block Themes icon 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
  59. Rox Hotel Booking icon Rox Hotel BookingFewer than 10 installs apply_filters( 'document_title_separator', '-' ) src/Modules/Seo/Services/SeoHead.php:315
  60. Logvia icon LogviaFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/class-logvia-frontend.php:195
  61. WPMMCC ATS icon WPMMCC ATSFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/hooks/class-virtual-site-seo.php:960
  62. Digispot AI icon Digispot AIFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/audit/class-preview-source.php:539
  63. Hydrogen SEO icon Hydrogen SEOFewer than 10 installs apply_filters( 'document_title_separator', '-' ) inc/modules/migration/sources/slim-seo/source.php:106
  64. RankHive icon RankHiveFewer than 10 installs apply_filters( 'document_title_separator', '-' ) src/SeoCheck/SeoMetaResolver.php:416
  65. Marzipan Commerce for Wineries icon Marzipan Commerce for WineriesFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/class-marzipan-seo.php:292
  66. Schema Guru icon Schema GuruFewer than 10 installs apply_filters( 'document_title_separator', '-' ) includes/functions.php:385
  67. Smart Woo Service Invoicing icon 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.