> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: customizeQuery(request: WixRouterRequest, route: string, query: WixDataQuery)

# Method package: wixRouter

# Method menu location: wixRouter --> customizeQuery

# Method Link: https://dev.wix.com/docs/velo/events-service-plugins/routers/service-plugins/wix-router/customize-query.md

# Method Description:

Registers a hook that is called after a route is resolved by the data binding router, but before the wix-data query is executed.

The `customizeQuery` hook is a data binding router hook that is triggered
before the data query is executed for the pages in the specified router.

The `customizeQuery()` function is not a function that you call from your code.
You define the function in a file named **routers.js** in the Code File's Backend section of the [Velo Sidebar](https://dev.wix.com/docs/develop-websites/articles/workspace-tools/velo-workspace/workspaces/wix-editor-working-with-the-code-sidebar.md).
The function is called as described above.

Use this hook to further refine or
change the query that will determine what data is bound to your page's
dataset. For example, you can filter the query to only return items that have
a `status` field set to `"active"`.

The function returns a [`WixDataQuery`](wix-data.WixDataQuery.html) object.
Typically the returned query is a modified version of the one the
function received.

The `customizeQuery()` hook is triggered when using dynamic pages, but not
when you code your own router.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Customize query stub

```javascript
// In routers.js

export function myRouter_customizeQuery(request, route, query) {
  // customize query code ...
}

```

## Filter query to return on active users

```javascript
// In routers.js

export function myRouter_customizeQuery(request, route, query) {
  if (route === "/users/{name}")
    return query.eq("status", "active");
  else
    return query;
}

```

---