Return Home

Overview

<attach>
<body>
<body>
<clientip>
<comment>
<configuration>
<copy>
<delay>
<dnslookup>
<domainquery>
<email>
<expression>
<expressions>
<file>
<filter>
<filters>
<header>
<header>
<helo>
<http>
<imap>
<index>
<inputpath>
<ipquery>
<log>
<mailfrom>
<maxbuffer>
<maxlines>
<message>
<modifysource>
<multiplerecipients>
<option>
<parser>
<path>
<quickresult>
<rcptto>
<result>
<results>
<return>
<rule>
<rules>
<scope>
<select>
<smtpextendedstatuscode>
<smtpstatuscode>
<target_filter>
<target_index>
<test>
<title>

Boolean type

Macros
Regular Expressions

Node: header

<header enabled="yes" action="add" item="itemname" value="itemvalue" />
<header enabled="yes" action="replace" item="itemname" value="itemvalue" />
<header enabled="yes" action="replaceoradd" item="itemname" value="itemvalue" />
<header enabled="yes" action="remove" item="itemname" />

Attributes:

enabled

yes
no

action

add
replace
replaceoradd
remove

item

name of the header item to add or replace

value

value of the header item

Notes

Adds or replaces a header line of the email being processed prior to delivery to the recipient.

The action attribute specifies the operation; a value of "add" always adds a new header line at the end of the existing headers. A value of "replace" searches for an existing header line matching the item attribute and replaces the value wiht the new one; no action takes place if the header line does not already exist. A value of "replaceoradd" functions just like "replace" except if the header line does not already exist, it is added at the end of the current header. A value of "remove" will remove any existing header line matching the item attribute.

Macros are expanded in the value attribute. Additionally, a macro named "{value}" is available referencing the existing value of the header line. If an existing header line does not exist the macro is defined as an empty string.

Consider this node to be under development. If you choose to use it, review any changes that may have been made since the prior version before upgrading.

Action "remove" is not yet implemented.

Revision History:

- Requires v2.1.8 or higher