---
title: Remove Query Parameters List for Policy Evaluation
description: A list of query parameters to be removed from the incoming URL for policy evaluation and caching.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.unwanted.http.url.param.list
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.unwanted.http.url.param.list.html
---

# Remove Query Parameters List for Policy Evaluation

A list of query parameters to be removed from the incoming URL for policy evaluation and caching.

The property has the following format, with no spaces between values:

`[Domain[/path]]|parameter[,parameter…​]`

Consider the following constraints when constructing the list of parameters:

* Add a comma (,) character at the beginning or the end of the list to remove all unnamed parameters. The following example would match both `lang` and any unnamed parameters: `myapp.example.com/customers|,lang`

* Add the asterisk (\*) character to the list to remove all parameters, including unnamed ones.

* The remaining parameters (those that do not match the list of parameters) are sorted alphabetically.

Examples:

`org.forgerock.agents.unwanted.http.url.param.list[0]=myapp.example.com/customers|location,lang`

`org.forgerock.agents.unwanted.http.url.param.list[1]=example.com/customers|*`

The following incoming URL request matches a rule such as `myapp.example.com/customers|,lang`:

`http://myapp.example.com/customers?country=uk&=bristol&lang=en_GB&area=1343456`

It is cached by the agent as `http://myapp.example.com/customers?area=1343456&country=uk`, where both `lang` and the unnamed parameter are removed and the rest of the parameters are sorted alphabetically.

|                          |                                                                                                                                                                                                                                                                   |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.unwanted.http.url.param.list`                                                                                                                                                                                                               |
| Aliases                  | `org.forgerock.agents.unwanted.http.url.param.list`   Introduced in Java Agent 5.6`org.forgerock.openam.agents.config.conditional.unwanted.http.url.params`   Introduced in Java Agent 5.6   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 7 |
| Function                 | Query parameter                                                                                                                                                                                                                                                   |
| Type                     | List                                                                                                                                                                                                                                                              |
| Bootstrap property       | No                                                                                                                                                                                                                                                                |
| Required property        | No                                                                                                                                                                                                                                                                |
| Restart required         | No                                                                                                                                                                                                                                                                |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                                                                          |
| AM console               | Tab: `Miscellaneous (from AM 7)`Title: `Remove Query Parameters List for Policy Evaluation`Legacy title: `Remove Query Parameters`                                                                                                                                |