Jabber Email Header

Tell the world that you use XMPP by including a "Jabber-ID" header in your outgoing email. This page describes how to set that up in various email clients. (Feel free to add the config for your email client, just put them in alphabetical order please. :-)

Note well: RFC 5322 does not allow anything but US-ASCII text in email headers, so if you have a Jabber ID with Unicode characters in it, you will need to escape those! See the Internet-Draft for details.

Claws Mail

In Claws Mail, do the following:

1. Configuration > Preferences > Message View > Text options
2. Select Display headers in message view
3. Add the "Jabber-ID" header

For adding the header in outgoing mails do the following:

1. Click Configuration > Edit Accounts > Edit
2. Select Send/Add user defined header
3. Choose the "Jabber-ID" header
4. Add the "Jabber-ID" header

Emacs

If you use mail-mode for composing mail, this should do the trick:

(if (not (string-match "Jabber-ID" mail-default-headers))
    (setq mail-default-headers
          (concat "Jabber-ID: your-jid-here\n"
                  mail-default-headers)))

If you use message-mode for composing mail (which you do if you use Gnus for reading mail), this should do the trick:

(if (not (string-match "Jabber-ID" message-default-headers))
    (setq message-default-headers
	  (concat "Jabber-ID: your-jid-here\n"
		  message-default-headers)))

This works for mu4e:

(add-hook 'mu4e-compose-mode-hook
     (defun my-add-jabberid ()
         "Add a Jabber-ID header."

(save-excursion (message-add-header (format "Jabber-ID: %s\n" "my-jid@my-server")))))

Displaying the header

This works in mu4e >= 1.12:

(add-to-list 'mu4e-header-info
    '(:jabber-id :name "Jabber-ID" :shortname "JID" :help "The Jabber ID" :sortable t))
(add-to-list 'mu4e-header-info-custom
    '(:jabber-id .
        ( :name "Jabber-ID"
          :shortname "JID"
          :help "The Jabber ID"
          :function (lambda (msg)
              (or (mu4e-fetch-field msg "Jabber-ID") "")))))
(setq mu4e-view-fields
    '(:from :to :cc :subject :flags :date :maildir :mailing-list :tags :jabber-id))

Evolution

In Evolution, do the following (source):

1. Select Edit > Plugins
2. Enable Custom Header
3. Click the Configuratin tab.
4. Add the "Jabber-ID" header

For adding the header in outgoing mails do the following:

1. Click New > Mail Message
2. Select Insert > Custom Header
3. Choose the "Jabber-ID" header

KMail

In KMail, do the following:

1. Select Settings > Configure KMail
2. Go to the Composer category
3. Select the Headers tab (some versions call this 'Message List')
4. Click on New
5. In the Name: field, type "Jabber-ID"
6. In the Value: field, type "[your-jid-here]"
7. Click OK

Mail.app

In Apple's Mail.app program, do the following:

1. Open a terminal window
2. Construct a command like:

defaults write com.apple.mail UserHeaders '{"Jabber-ID" = "your-jid-here";}'

Mutt

In Mutt, do the following:

1. Open your .muttrc file
2. In the Composing section (or wherever) add a line that reads

my_hdr Jabber-ID: your-jid-here

Displaying the header

To show the header for incoming mails add the following to the .muttrc file:

unignore Jabber-ID

Thunderbird

In Thunderbird, you need to define two separate config options, so do the following:

1. Open the Preferences
2. Click the Advanced icon
3. Click the General tab
4. Click the Config Editor button
5. Right-click anywhere in the about:config window
6. Select New -> String
7. For the preference name, type mail.identity.id.header.jid
8. For the preference value, type Jabber-ID: your-jid-here
9. That's the first pref; now right-click anywhere in the about:config window
10. Select New -> String
11. For the preference name, type mail.identity.id.headers
12. For the preference value, type jid
13. If you have multiple accounts in Thunderbird, differentiate them with mail.identity.id1... and mail.identity.id2 (etc.)

Note: In the preference name for Step 7 and the preference value for Step 12, the string "jid" can be anything, as long as the string is the same for both.

Displaying the header

The preference mailnews.headers.extraExpandedHeaders is a list of space-delimited additional headers to be shown in the header section of the message pane. To show the Jabber-ID header on messages, just add Jabber-ID to this preference.

Mail Gateways

More e-mail header information in Email Gateway page.