Using Field Tags

Some of the settings available in Ability Mail Server allow insertion of special field tags, which are replaced with important information when used. This allows messages to contain useful information, such as the subject of a mail, the current time, the administrator's email address and more. If you want to know if a setting allows the use of field tags, the relevant section in the manual will inform you. Each tag should be used in the form ####TAG####. The table below describes what tags are available.


All field tag settings.

  • ADMINEMAIL - Admin email address.
  • CURRENTTIME - Current time and date.
  • FROMIP - Relevant IP address.
  • REVERSEFROMIP - Relevant IP address in reverse format.

Any field tag setting which is in response to another mail (e.g. Mailing List notifications, Content Filtering).

  • SUBJECT - Subject of the original mail.
  • SIZEKB - Size in KB of the original mail.
  • SIZE - Size in bytes of the original mail.
  • SENTTIME - Text of the 'Date' mail header line.
  • SMTPFROMHOST - SMTP envelope host address of the original mail.
  • FROMADDRESS - SMTP envelope sender of the original mail.
  • FROMPERSONALDATACOMMONNAME - Common Name of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATAEMAILADDRESS - Email Address of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATAFIRSTNAME - First Name of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATASURNAME - Surname of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATAORGANIZATION - Organization of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATADEPARTMENT - Department of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATASTREET - Street Address of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATACITY - Town / City of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATASTATE - State / Province of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATACOUNTRY - Country of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATAPOSTCODE - Zip / Postal Code of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATATELEPHONE - Telephone Number of the SMTP envelope sender's Personal Data if the sender exists locally.
  • FROMPERSONALDATADESCRIPTION - Description of the SMTP envelope sender's Personal Data if the sender exists locally.
  • TOADDRESSCOMMALIST - SMTP envelope recipients of the original mail in a comma separated list.
  • TOADDRESSLIST - SMTP envelope recipients of the original mail in a multi-line list.
  • TOHEADERADDRESSLIST - SMTP envelope recipients of the original mail in a mail header address list format.
  • HEADERFROMADDRESS - Mail header 'From' address of the original mail.
  • HEADERREPLYTOADDRESS - Mail header 'Reply-To' address of the original mail.
  • HEADERTOADDRESSCOMMALIST - Mail header 'To' addresses of the original mail in a comma separated list.
  • HEADERTOADDRESSLIST - Mail header 'To' addresses of the original mail in a multi-line list.
  • HEADERTOHEADERADDRESSLIST - Mail header 'To' addresses of the original mail in a mail header address list format.
  • HEADERCCADDRESSCOMMALIST - Mail header 'Cc' addresses of the original mail in a comma separated list.
  • HEADERCCADDRESSLIST - Mail header 'Cc' addresses of the original mail in a multi-line list./li>
  • HEADERCCHEADERADDRESSLIST - Mail header 'Cc' addresses of the original mail in a mail header address list format.
  • HEADERBCCADDRESSCOMMALIST - Mail header 'Bcc' addresses of the original mail in a comma separated list.
  • HEADERBCCADDRESSLIST - Mail header 'Bcc' addresses of the original mail in a multi-line list.
  • HEADERBCCHEADERADDRESSLIST - Mail header 'Bcc' addresses of the original mail in a mail header address list format.
  • HOPCOUNT - Hop count value of the original mail.
  • STRIPPEDPARTSCOMMALIST - Any parts stripped from the mail in a comma separated list.
  • STRIPPEDPARTSLIST - Any parts stripped from the mail in a multi-line list.
  • CUSTOMEVENTSCOMMALIST - The custom events in a comma separated list.
  • CUSTOMEVENTSLIST - The custom events in a multi-line list.
  • ATTACHMENTSCOMMALIST - Attachment file names of the original mail in a comma separated list.
  • ATTACHMENTSLIST - Attachment file names of the original mail in a multi-line list.
  • DKIMRESULT - The DKIM SPAM filter result.
  • DKIMRESULTDETAIL - A more specific DKIM SPAM filter result message.
  • SPFRESULT - The SPF SPAM filter result.
  • SPFREASON - The reason for the SPF FAIL result.
  • BAYESIANSCORE - Bayesian score value of the original mail.

Filter Action - Edit Header Field

  • ORIGHEADERTEXT - Inserts the original mail header. This allows appending or pre-appending to existing headers.

SPAM Filtering: DKIM FAIL / PERMERROR Result Refuse Message

  • DKIMRESULTDETAIL - The reason for the DKIM SPAM filter result.

SPAM Filtering: SPF FAIL Result Refuse Message

  • SPFREASON - The reason for the SPF FAIL result.

Mailing List Auto-Add, Auto-Remove or notification mails.

  • MAILINGLISTADDRESS - Email address of the Mailing List.
  • ADDRESSCOUNT - Number of email addresses in the delivery information of the Mailing List.
  • DOMAINCOUNT - Number of domains in the delivery information of the Mailing List.
  • GROUPCOUNT - Number of groups in the delivery information of the Mailing List.
  • ADDRESSESADDEDTODAYCOUNT - Number of email addresses added so far today.
  • ADDRESSESREMOVEDTODAYCOUNT - Number of email addresses removed so far today.
  • TRIGGEREDTODAYCOUNT - Number of triggers of the Mailing List so far today.

Mailing List notification mails

  • ACTION - Action which triggered the notification.
  • DETAILS - Any relevant details about the notification action.

Message: 'Failure Mail - Too Many Hops'

  • MAXHOPCOUNT - Maximum number of allowed hop counts.

Message: 'WebMail - Admin Email (Body)'

  • POSTLIST - List of all sign-up form fields in a multi-line list.

Messages: 'Failure Mail - Undeliverable' and 'Failure Mail - Undeliverable Warning'

  • INQUEUETIMEMINS - Value in minutes representing the amount of time the mail has been in the queue.
  • TOTALMAXQUEUETIMEMINS - Value in minutes representing the maximum life of mails in the queue.
  • RETRYTIMEMINS - Value in minutes representing the resend delay.
  • TOANDFAILURELIST - Pre-formatted list of the failed delivery recipients and the reasons.

Message: 'Other - Stripped Attachment'

  • REMOVEDATTACHMENTS - List of all removed attachments in a multi-line list.

Message: 'Notification Mail - Transmission Success'

  • TOSUCCESSLIST - List of all successful external recipients in a multi-line list.

See Also: General.