Modify Incoming Request Header

Modify, add, remove, or pass along specific request headers coming upstream from the client.

Why you need it

Use this behavior to decide how selected request headers coming upstream from the client should be processed. For example, you can add headers such as Accept-Encoding or Accept-Language if they are required by the back-end services. By controlling the content of your headers you can further customize your website visitor's experience and gain insight into how it's used.

How it works

When enabled, this behavior modifies the specified incoming request header according to set rules.

Features and options

FieldWhat it doesSub-options
ActionSpecifies the action to perform on the header.
  • Add
  • Remove
  • Modify. This option replaces the entire value of the header.
  • Pass. Make no change to the header.
Select Header NameSelects from standard pre-defined headers to modify.With Action set to Add, Modify or Pass.
  • Accept-Encoding
  • Accept-Language
  • Other...


With Action set to Remove.
  • If-Modified-Since
  • Via
  • Other...
Header ValueWith Action set to Add, enter your HTTP header value.

Variable Support: This option supports variable expression syntax. Typing {{ in the option field triggers variable auto complete. Learn more about variable support.
Custom Header NameWith Select Header Name set to Other..., enter a custom HTTP header name.

Variable Support: This option supports variable expression syntax. Typing {{ in the option field triggers variable auto complete. Learn more about variable support.
New Header ValueWith Action set to Modify, enter your new HTTP header value.

Variable Support: This option supports variable expression syntax. Typing {{ in the option field triggers variable auto complete. Learn more about variable support.
Avoid Duplicate HeadersWith Action set to Modify, prevents multiple headers with the same name from being created.