Reserved URL query parameters

GravityView uses URL query parameters to control how entries are displayed, filtered and otherwise manipulated. For example, gv_search=cats&mode=any is added to the URL query string when searching for entries that contain cats as the field value. The plugin also tries to preserve query parameters added by other plugins when navigating between pages.

However, to prevent possible conflicts with other plugins that use the same URL parameter names, GravityView clears their values and prevents them from being passed from one request to another. The list of these reserved parameters includes:

  • action
  • duplicate
  • entry
  • entry_id
  • gvid
  • gv_search
  • gv_start
  • gv_end
  • gv_id
  • gv_by
  • mode
  • status
  • view_id
  • Occasionally, this may affect the behavior of your website. Should this happen, you can whitelist specific parameters by using the gravityview/api/reserved_query_args filter as follows:

    function gv_whitelist_url_query_parameters( $reserved_parameters ) {
        unset( $reserved_parameters['parameter_name'] ); // replace `parameter_name` with the one being whitelisted
    
        return $reserved_parameters;
    }
    
    add_filter( 'gravityview/api/reserved_query_args', 'gv_whitelist_url_query_parameters' );
    	
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us