---
title: Custom Response Header Map
description: A key:value map of custom headers set by the agent for the client, where the key is the header name, and the value is the header value. For example, org.forgerock.agents.response.header.map[Cache-Control]=no-cache
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.response.header.map
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.response.header.map.html
---

# Custom Response Header Map

A key:value map of custom headers set by the agent for the client, where the key is the header name, and the value is the header value. For example, `org.forgerock.agents.response.header.map[Cache-Control]=no-cache`

Format `org.forgerock.agents.response.header.map[HEADER-NAME]=HEADER-VALUE`

|                          |                                                                                                                                                                                                                                 |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.response.header.map`                                                                                                                                                                                      |
| Aliases                  | `org.forgerock.agents.response.header.map`   Introduced in Java Agent 5.6`com.sun.identity.agents.config.response.header`   Introduced in Java Agent 5.0   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 6 |
| Function                 | Miscellaneous                                                                                                                                                                                                                   |
| Type                     | Map- Keys: from header

- Values: to header                                                                                                                                                                                     |
| Bootstrap property       | No                                                                                                                                                                                                                              |
| Required property        | No                                                                                                                                                                                                                              |
| Restart required         | No                                                                                                                                                                                                                              |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                                        |
| AM console               | Tab: `Global`Title: `Custom Response Header Map`Legacy title: `Custom Response Header`                                                                                                                                          |