---
title: "Reserved URL query parameters"
date: 2026-04-23
author: "GravityKit"
link: "https://www.gravitykit.com/docs/gravityview/common-problems/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' );
```

```
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' );
```