---
title: Conditional Logout URL List
description: Define URLs to which the agent can conditionally direct the user on logout. This property does not trigger logout.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.conditional.logout.url.list
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.conditional.logout.url.list.html
---

# Conditional Logout URL List

Define URLs to which the agent can conditionally direct the user on logout. This property does not trigger logout.

Configure one or more conditions, using this format:

`domain/path|url?param1=value1&param2=value2`

The request URL is compared to each condition in the list until a match is found. Conditions are evaluated by order of length, starting with the longest, irrespective of their order in the list.

Depending on the value of the redirection URL, perform this additional configuration:

* If the URL doesn't perform a REST logout to AM, set [Always invalidate sessions](org.forgerock.agents.config.logout.session.invalidate.enabled.html) to `true`. The agent additionally invokes the AM REST logout endpoint to invalidate the session.

* If the URL isn't relative to an AM URL, or in the same scheme, FQDN, and port as an AM URL, add it to the AM validation service.

In the following example, `example.com/path` is evaluated before `example.com`; the default condition is the shortest, and is evaluated last:

`org.forgerock.agents.conditional.logout.url.list[0]=example.com|?additional=value`

`org.forgerock.agents.conditional.logout.url.list[1]=example.com/path|?one=red&two=green&three=blue`

`org.forgerock.agents.conditional.logout.url.list[2]=mybank.com|http://mybank.com/myapp/logout?param=override`

`org.forgerock.agents.conditional.logout.url.list[3]=|?alpha=beta`

For more information, refer to [Conditionally log out to different URLs](../user-guide/logout.html#conditionally_log_out_to_different_urls).

|                          |                                                                                                                                                                                                                                                    |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.conditional.logout.url.list`                                                                                                                                                                                                 |
| Aliases                  | `org.forgerock.openam.agents.config.conditional.logout.url`   Introduced in Java Agent 5.6   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 6`org.forgerock.agents.conditional.logout.url.list`   Introduced in Java Agent 5.6 |
| Function                 | Logout                                                                                                                                                                                                                                             |
| Type                     | List                                                                                                                                                                                                                                               |
| Bootstrap property       | No                                                                                                                                                                                                                                                 |
| Required property        | No                                                                                                                                                                                                                                                 |
| Restart required         | No                                                                                                                                                                                                                                                 |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                                                           |
| AM console               | Tab: `AM Services`Title: `Conditional Logout URL List`Legacy title: `AM Conditional Logout URL`                                                                                                                                                    |
