modifyIncomingResponseHeader

Property Manager name: Modify Incoming Response Header
Behavior version: The v2026-01-09 rule format supports the modifyIncomingResponseHeader behavior v1.2.
Rule format status: GA, stable
Access: Read/Write
Allowed in includes: Yes

Modify, add, remove, or pass along specific response headers coming downstream from the origin.

Depending on the type of action you want to perform, specify the corresponding standard header name, or a customHeaderName if the standard name is set to OTHER. The headerValue serves as a match condition when the action is DELETE or MODIFY, and the newHeaderValue applies when the action is ADD or MODIFY.

Option	Type	Description	Requires
`action`	enum	Either `ADD`, `DELETE`, `MODIFY`, or `PASS` incoming HTTP response headers.		{"displayType":"enum","options":["ADD","DELETE","MODIFY","PASS"],"tag":"select"}
	`ADD`	Add the header.
	`DELETE`	Delete the header.
	`MODIFY`	Modify the header.
	`PASS`	Pass through the header.
`standardAddHeaderName`	enum	If the value of `action` is `ADD`, this specifies the name of the field to add.	`action` is `ADD`	{"displayType":"enum","options":["CACHE_CONTROL","CONTENT_TYPE","EDGE_CONTROL","EXPIRES","LAST_MODIFIED","OTHER"],"tag":"select"} {"if":{"attribute":"action","op":"eq","value":"ADD"}}
	`CACHE_CONTROL`	The `Cache-Control` header.
	`CONTENT_TYPE`	The `Content-Type` header.
	`EDGE_CONTROL`	The `Edge-Control` header.
	`EXPIRES`	The `Expires` header.
	`LAST_MODIFIED`	The `Last-Modified` header.
	`OTHER`	Specify another header to add.
`standardDeleteHeaderName`	enum	If the value of `action` is `DELETE`, this specifies the name of the field to remove.	`action` is `DELETE`	{"displayType":"enum","options":["CACHE_CONTROL","CONTENT_TYPE","VARY","OTHER"],"tag":"select"} {"if":{"attribute":"action","op":"eq","value":"DELETE"}}
	`CACHE_CONTROL`	The `Cache-Control` header.
	`CONTENT_TYPE`	The `Content-Type` header.
	`VARY`	The `Vary` header.
	`OTHER`	Specify another header to remove.
`standardModifyHeaderName`	enum	If the value of `action` is `MODIFY`, this specifies the name of the field to modify.	`action` is `MODIFY`	{"displayType":"enum","options":["CACHE_CONTROL","CONTENT_TYPE","EDGE_CONTROL","OTHER"],"tag":"select"} {"if":{"attribute":"action","op":"eq","value":"MODIFY"}}
	`CACHE_CONTROL`	The `Cache-Control` header.
	`CONTENT_TYPE`	The `Content-Type` header.
	`EDGE_CONTROL`	The `Edge-Control` header.
	`OTHER`	Specify another header to modify.
`standardPassHeaderName`	enum	If the value of `action` is `PASS`, this specifies the name of the field to pass through.	`action` is `PASS`	{"displayType":"enum","options":["CACHE_CONTROL","EXPIRES","PRAGMA","OTHER"],"tag":"select"} {"if":{"attribute":"action","op":"eq","value":"PASS"}}
	`CACHE_CONTROL`	Pass through the `Cache-Control` header.
	`EXPIRES`	Pass through the `Expires` header.
	`PRAGMA`	Pass through the `Pragma` header.
	`OTHER`	Specify another header to pass.
`customHeaderName`	string (allows variables)	Specifies a custom field name that applies when the relevant standard header name is set to `OTHER`.	`standardAddHeaderName` is `OTHER` OR `standardDeleteHeaderName` is `OTHER` OR `standardModifyHeaderName` is `OTHER` OR `standardPassHeaderName` is `OTHER`	{"displayType":"string","tag":"input","type":"text"} {"if":{"op":"or","params":[{"attribute":"standardAddHeaderName","op":"eq","value":"OTHER"},{"attribute":"standardDeleteHeaderName","op":"eq","value":"OTHER"},{"attribute":"standardModifyHeaderName","op":"eq","value":"OTHER"},{"attribute":"standardPassHeaderName","op":"eq","value":"OTHER"}]}}
`headerValue`	string (allows variables)	Specifies the header's new value.	`action` is `ADD`	{"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"action","op":"eq","value":"ADD"}}
`newHeaderValue`	string (allows variables)	Specifies an HTTP header replacement value.	`action` is `MODIFY`	{"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"action","op":"eq","value":"MODIFY"}}
`avoidDuplicateHeaders`	boolean	When enabled with the `action` set to `MODIFY`, prevents creation of more than one instance of a header.	`action` is `MODIFY`	{"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"action","op":"eq","value":"MODIFY"}}