---
title: Query Parameter List for Policy Evaluation
description: A list of query parameters to be retained for policy evaluation and caching purposes. The property has the following format, with no spaces between values:
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.wanted.http.url.param.list
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.wanted.http.url.param.list.html
---

# Query Parameter List for Policy Evaluation

A list of query parameters to be retained for policy evaluation and caching purposes. 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 retain all unnamed parameters. For example, `myapp.example.com/customers|,lang` matches both `lang` and any unnamed parameters.

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

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

Examples:

`org.forgerock.agents.wanted.http.url.param.list[0]=myapp.example.com/news|area`

`org.forgerock.agents.wanted.http.url.param.list[1]=example.com/news|area,country,location,`

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?=bristol&lang=en_GB`, where both `lang` and the unnamed parameter are retained and sorted alphabetically.

|                          |                                                                                                                                                                                                                                                               |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.wanted.http.url.param.list`                                                                                                                                                                                                             |
| Aliases                  | `org.forgerock.openam.agents.config.conditional.wanted.http.url.params`   Introduced in Java Agent 5.6   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 7`org.forgerock.agents.wanted.http.url.param.list`   Introduced in Java Agent 5.6 |
| 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: `Query Parameter List for Policy Evaluation`Legacy title: `Retain Query Parameters`                                                                                                                                    |