WordPress filter hook · part of WordPress core

query_vars

A WordPress core filter that 47 plugins also fire themselves, running on 13M+ sites between them.

“Filter the publicly allowed query vars.”

How to use query_vars

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( 'query_vars', function( $public_query_vars ) {
	// Change $public_query_vars here.
	return $public_query_vars;
}, 10, 1 );

Argument names come from WooCommerce'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 →

47 plugins that fire query_vars

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. WooCommerce icon WooCommerce7+ million installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/rest-api/Controllers/Version3/class-wc-rest-posts-controller.php:555
  2. Site Kit by Google icon Site Kit by Google5+ million installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/Core/Util/WP_Query_Factory.php:79
  3. The Events Calendar icon The Events Calendar600,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) common/src/Tribe/Rewrite.php:1045
  4. Event Tickets and Registration icon Event Tickets and Registration90,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) common/src/Tribe/Rewrite.php:1045
  5. HUSKY icon HUSKY80,000+ installs apply_filters( 'query_vars', $WP->public_query_vars ) ext/url_request/classes/url_parser.php:173
  6. Filter Everything icon Filter Everything50,000+ installs apply_filters( 'query_vars', $WP->public_query_vars ) src/WpManager.php:1027
  7. WPGraphQL icon WPGraphQL30,000+ installs apply_filters( 'query_vars', $this->wp->public_query_vars ) src/Data/NodeResolver.php:588
  8. Dokan: AI Powered WooCommerce Multivendor Marketplace Solution icon Dokan: AI Powered WooCommerce Multivendor Marketplace Solution30,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/Abstracts/DokanRESTController.php:427
  9. Directorist: AI-Powered Business Directory, Listings & Classified Ads icon Directorist: AI-Powered Business Directory, Listings & Classified Ads20,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/rest-api/Version1/class-abstract-posts-controller.php:33
  10. Seriously Simple Podcasting icon Seriously Simple Podcasting20,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) php/classes/rest/class-episodes-rest-controller.php:986
  11. MotoPress Hotel Booking icon MotoPress Hotel Booking10,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/advanced/api/controllers/abstract-rest-object-controller.php:772
  12. GamiPress icon GamiPress10,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/api/class-wp-rest-gamipress-posts-controller.php:261
  13. WordPress REST API (Version 2) icon WordPress REST API (Version 2)10,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) lib/endpoints/class-wp-rest-posts-controller.php:707
  14. Royal MCP icon Royal MCP10,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/Integrations/Coexistence_Check.php:553
  15. 404 Solution: Redirection and Page Suggestions icon 404 Solution: Redirection and Page Suggestions10,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/core/QueryStringHelper.php:123
  16. Masteriyo LMS icon Masteriyo LMS6,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/RestApi/Controllers/Version1/CommentsController.php:487
  17. Payment forms, Buy now buttons, and Invoicing System icon Payment forms, Buy now buttons, and Invoicing System5,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/api/class-getpaid-rest-posts-controller.php:453
  18. MotoPress Appointment Booking icon MotoPress Appointment Booking2,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/rest/controllers/AbstractRestObjectController.php:433
  19. Monkeyman Rewrite Analyzer icon Monkeyman Rewrite Analyzer1,000+ installs apply_filters( 'query_vars', $GLOBALS['wp']->public_query_vars ) include/class-monkeyman-rewrite-analyzer.php:75
  20. WCFM icon WCFM1,000+ installs apply_filters( 'query_vars', $wp->public_query_vars ) core/class-wcfmapi-rest-controller.php:368
  21. Url Rewrite Analyzer icon Url Rewrite Analyzer400+ installs apply_filters( 'query_vars', $GLOBALS['wp']->public_query_vars ) include/class-urap-url-rewrite-analyzer.php:68
  22. AFB icon AFB200+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/helpers/class-auto-form-builder-redirect-url.php:163
  23. Creator LMS icon Creator LMS100+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/Rest/V1/CertificateController.php:631
  24. Appmaker WP icon Appmaker WP100+ installs apply_filters( 'query_vars', $wp->public_query_vars ) lib/endpoints/appmaker/class-appmaker-wp-rest-backend-posts-controller.php:372
  25. WP Rest Api V2 Multiple PostTypes icon WP Rest Api V2 Multiple PostTypes100+ installs apply_filters( 'query_vars', $wp->public_query_vars ) lib/endpoints/class-wp-rest-multiple-posttype-controller.php:277
  26. Conversational Forms for Gravity Forms icon Conversational Forms for Gravity Forms50+ installs apply_filters( 'query_vars', array( $this, 'add_query_vars' ) ) wpm-gravity-conversational-core.php:71
  27. Reactor: Core icon Reactor: Core30+ installs apply_filters( 'query_vars', $wp->public_query_vars ) json-rest-api/lib/class-wp-json-posts.php:131
  28. PZZ API Client icon PZZ API Client20+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/class-pzz-json-posts-controller.php:103
  29. AJAX Search, Filtering and Sorting for WordPress & WooCommerce icon AJAX Search, Filtering and Sorting for WordPress & WooCommerce10+ installs apply_filters( 'query_vars', $WP->public_query_vars ) src/WpManager.php:988
  30. Fundrizer Lite icon Fundrizer Lite10+ installs apply_filters( 'query_vars', $this->wp->public_query_vars ) deps/wp-graphql/src/Data/NodeResolver.php:514
  31. Ultimate AMP icon Ultimate AMP10+ installs apply_filters( 'query_vars', $wp->public_query_vars ) ultimate-amp.php:404
  32. SaleDash icon SaleDash10+ installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/abstract/abstract-wc-rest-posts-controller.php:257
  33. Avalon23 Products Filter for WooCommerce icon Avalon23 Products Filter for WooCommerce10+ installs apply_filters( 'query_vars', $WP->public_query_vars ) classes/url-parse.php:186
  34. NodeifyWP icon NodeifyWP10+ installs apply_filters( 'query_vars', $wp->public_query_vars ) UrlToQueryItem.php:276
  35. The Events Calendar: oEmbed icon The Events Calendar: oEmbed10+ installs apply_filters( 'query_vars', $this->public_query_vars ) lib/tribe_ombed_service.php:151
  36. AdSimple Vote icon AdSimple Vote10+ installs apply_filters( 'query_vars', $wp->public_query_vars ) adsimple-vote.php:1102
  37. WP-BigApp icon WP-BigApp10+ installs apply_filters( 'query_vars', $wp->public_query_vars ) lib/json/class-wp-json-posts.php:113
  38. prograpper icon prograpper10+ installs apply_filters( 'query_vars', $wp->public_query_vars ) wp-api/lib/class-wp-json-posts.php:130
  39. Utmatra icon UtmatraFewer than 10 installs apply_filters( 'query_vars', $wp->public_query_vars ) src/Tracking/Tracker.php:208
  40. shawesome Contextual 404 icon shawesome Contextual 404Fewer than 10 installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/resolver.php:137
  41. Superstore icon SuperstoreFewer than 10 installs apply_filters( 'query_vars', $wp->public_query_vars ) includes/Abstracts/AbstractRestPostsController.php:351
  42. WpApper icon WpApperFewer than 10 installs apply_filters( 'query_vars', $wp->public_query_vars ) lib/json/class-wp-json-posts.php:113
  43. Fabrement Lite icon Fabrement LiteFewer than 10 installs apply_filters( 'query_vars', $wp->public_query_vars ) src/Modules/Seo/SiteQueryVars.php:22
  44. Velocity Forge icon Velocity ForgeFewer than 10 installs apply_filters( 'query_vars', $base ) includes/class-url.php:99
  45. LanternWP Companion icon LanternWP CompanionFewer than 10 installs apply_filters( 'query_vars', $wp->public_query_vars ) src/Settings/Addresses.php:135
  46. WP-Restify icon WP-RestifyFewer than 10 installs apply_filters( 'query_vars', $wp->public_query_vars ) include/class-wp-json-posts.php:131
  47. WP eCommerce Betaout icon WP eCommerce BetaoutFewer than 10 installs apply_filters( 'query_vars', $wp->public_query_vars ) lib/class-wp-json-wpecproduct.php:78

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.