---
title: Retain previous override behaviour
description: When true, the agent does not substitute the Alternative Agent Host Name, Alternative Agent Port Number or Alternative Agent Protocol into the URL used for matching against not enforced rules, or policy evaluation.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.retain.previous.override.behaviour.enabled
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.retain.previous.override.behaviour.enabled.html
---

# Retain previous override behaviour

When `true`, the agent does not substitute the [Alternative Agent Host Name](org.forgerock.agents.agent.hostname.html), [Alternative Agent Port Number](org.forgerock.agents.agent.port.html) or [Alternative Agent Protocol](org.forgerock.agents.agent.protocol.html) into the URL used for matching against not enforced rules, or policy evaluation.

When `false`, the values are substituted as expected.

The default value preserves backward compatibility.

|                          |                                                                                                     |
| ------------------------ | --------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.retain.previous.override.behaviour.enabled`                                   |
| Aliases                  | `org.forgerock.agents.retain.previous.override.behaviour.enabled`   Introduced in Java Agent 2023.6 |
| Function                 | Configure behaviour                                                                                 |
| Type                     | Boolean: `true` returns true; all other strings return `false`.                                     |
| Default                  | `true`                                                                                              |
| Bootstrap property       | No                                                                                                  |
| Required property        | No                                                                                                  |
| Restart required         | No                                                                                                  |
| Local configuration file | `AgentConfig.properties`                                                                            |