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:
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.
-
WooCommerce7+ million installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/rest-api/Controllers/Version3/class-wc-rest-posts-controller.php:555 -
Site Kit by Google5+ million installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/Core/Util/WP_Query_Factory.php:79 -
The Events Calendar600,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )common/src/Tribe/Rewrite.php:1045 -
Event Tickets and Registration90,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )common/src/Tribe/Rewrite.php:1045 -
HUSKY80,000+ installs
apply_filters( 'query_vars', $WP->public_query_vars )ext/url_request/classes/url_parser.php:173 -
Filter Everything50,000+ installs
apply_filters( 'query_vars', $WP->public_query_vars )src/WpManager.php:1027 -
WPGraphQL30,000+ installs
apply_filters( 'query_vars', $this->wp->public_query_vars )src/Data/NodeResolver.php:588 -
Dokan: AI Powered WooCommerce Multivendor Marketplace Solution30,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/Abstracts/DokanRESTController.php:427 -
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 -
Seriously Simple Podcasting20,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )php/classes/rest/class-episodes-rest-controller.php:986 -
MotoPress Hotel Booking10,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/advanced/api/controllers/abstract-rest-object-controller.php:772 -
GamiPress10,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/api/class-wp-rest-gamipress-posts-controller.php:261 -
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 -
Royal MCP10,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/Integrations/Coexistence_Check.php:553 -
404 Solution: Redirection and Page Suggestions10,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/core/QueryStringHelper.php:123 -
Masteriyo LMS6,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/RestApi/Controllers/Version1/CommentsController.php:487 -
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 -
MotoPress Appointment Booking2,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/rest/controllers/AbstractRestObjectController.php:433 -
Monkeyman Rewrite Analyzer1,000+ installs
apply_filters( 'query_vars', $GLOBALS['wp']->public_query_vars )include/class-monkeyman-rewrite-analyzer.php:75 -
WCFM1,000+ installs
apply_filters( 'query_vars', $wp->public_query_vars )core/class-wcfmapi-rest-controller.php:368 -
Url Rewrite Analyzer400+ installs
apply_filters( 'query_vars', $GLOBALS['wp']->public_query_vars )include/class-urap-url-rewrite-analyzer.php:68 -
AFB200+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/helpers/class-auto-form-builder-redirect-url.php:163 -
Creator LMS100+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/Rest/V1/CertificateController.php:631 -
Appmaker WP100+ installs
apply_filters( 'query_vars', $wp->public_query_vars )lib/endpoints/appmaker/class-appmaker-wp-rest-backend-posts-controller.php:372 -
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 -
Conversational Forms for Gravity Forms50+ installs
apply_filters( 'query_vars', array( $this, 'add_query_vars' ) )wpm-gravity-conversational-core.php:71 -
Reactor: Core30+ installs
apply_filters( 'query_vars', $wp->public_query_vars )json-rest-api/lib/class-wp-json-posts.php:131 -
PZZ API Client20+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/class-pzz-json-posts-controller.php:103 -
AJAX Search, Filtering and Sorting for WordPress & WooCommerce10+ installs
apply_filters( 'query_vars', $WP->public_query_vars )src/WpManager.php:988 -
Fundrizer Lite10+ installs
apply_filters( 'query_vars', $this->wp->public_query_vars )deps/wp-graphql/src/Data/NodeResolver.php:514 -
Ultimate AMP10+ installs
apply_filters( 'query_vars', $wp->public_query_vars )ultimate-amp.php:404 -
SaleDash10+ installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/abstract/abstract-wc-rest-posts-controller.php:257 -
Avalon23 Products Filter for WooCommerce10+ installs
apply_filters( 'query_vars', $WP->public_query_vars )classes/url-parse.php:186 -
NodeifyWP10+ installs
apply_filters( 'query_vars', $wp->public_query_vars )UrlToQueryItem.php:276 -
The Events Calendar: oEmbed10+ installs
apply_filters( 'query_vars', $this->public_query_vars )lib/tribe_ombed_service.php:151 -
AdSimple Vote10+ installs
apply_filters( 'query_vars', $wp->public_query_vars )adsimple-vote.php:1102 -
WP-BigApp10+ installs
apply_filters( 'query_vars', $wp->public_query_vars )lib/json/class-wp-json-posts.php:113 -
prograpper10+ installs
apply_filters( 'query_vars', $wp->public_query_vars )wp-api/lib/class-wp-json-posts.php:130 -
UtmatraFewer than 10 installs
apply_filters( 'query_vars', $wp->public_query_vars )src/Tracking/Tracker.php:208 -
shawesome Contextual 404Fewer than 10 installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/resolver.php:137 -
SuperstoreFewer than 10 installs
apply_filters( 'query_vars', $wp->public_query_vars )includes/Abstracts/AbstractRestPostsController.php:351 -
WpApperFewer than 10 installs
apply_filters( 'query_vars', $wp->public_query_vars )lib/json/class-wp-json-posts.php:113 -
Fabrement LiteFewer than 10 installs
apply_filters( 'query_vars', $wp->public_query_vars )src/Modules/Seo/SiteQueryVars.php:22 -
Velocity ForgeFewer than 10 installs
apply_filters( 'query_vars', $base )includes/class-url.php:99 -
LanternWP CompanionFewer than 10 installs
apply_filters( 'query_vars', $wp->public_query_vars )src/Settings/Addresses.php:135 -
WP-RestifyFewer than 10 installs
apply_filters( 'query_vars', $wp->public_query_vars )include/class-wp-json-posts.php:131 -
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.