Child pages
  • Using postfix header_checks to re-write From headers
Skip to end of metadata
Go to start of metadata


This page explains how to use postfix header_checks to re-write "From:" headers, specifically to adjust the display name.

It was developed and tested on a Debian 6 Squeeze system running postfix 2.7.1 using POSIX regular expressions.


The terms used for address components on this page are taken from RFC2822 (  Using example address

"Mr Foo" <>

  •  "Mr Foo" is the display-name
  • <> is angle-addr

The essential steps

Create /etc/postfix/header_checks (discussed below) then run these commands

cd /etc/postfix
postconf -e 'smtp_header_checks = regexp:/etc/postfix/header_checks'
/etc/init.d/postfix reload

Developing the header_checks file

Line format

For present purposes, each effective line of the header_checks file is of the form

/pattern/ REPLACE text...

The pattern

The /pattern/ is a POSIX regular expression matching the "FROM:" header.  So it always begins with


The pattern should always be anchored to the start of the line using ^.  This ensures no false positives (such as matching "From:" in some other header such as the subject) and gives better postfix performance (postfix does not have to scan the whole of each header looking for the match).

The rest of the pattern depends on local requirements – what you want to match.

Any whitespace in the pattern should be represented by [[:space:]].  This avoids warnings from postmap such as "record is in "key: value" format; is this an alias file?" and "duplicate entry".

The text

  • display-name needs double quotes.
  • angle-addr needs the < and > characters.

Development techniques

To find out what's after the "From:":

  1. If the regex matches, the original headers can be displayed by
         grep -o 'replace: header .*$' /var/log/
  2. Keep the original header text in the re-written header by using back-substitution in header_checks like (replace <email_address>):
         /^From:[[:space:]]+(.*)/ REPLACE From: ">${1}<" <email_address>



There are few HOWTO pages on the Internet about this topic.  The ones found most useful were:


  • No labels