Set up extra headers for emails sent by a given Mail Server.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Lets you add custom email headers to every message sent through a specific outgoing mail server, configured directly on the server form.
This module extends the outgoing mail server configuration in Odoo so you can attach extra technical headers to all emails sent through that server.
On the outgoing mail server form (Settings > Technical > Outgoing Mail Servers), a new field appears right after the SMTP password. You enter the headers as a Python-style dictionary, for example {"MY-HEADER": "test"}. The field uses a code editor widget.
Business rules added by the module: - The value must be a valid dictionary where every key and every value is text; otherwise Odoo blocks saving and shows a validation error. - If the text cannot be parsed at all, a syntax error message is shown. - When an email is actually sent, the configured headers are automatically added to the message before it goes out. - If the field is left empty, nothing is added.
The module touches the ir.mail_server model and its form view. It does not add menus, reports or scheduled actions of its own; it works silently in the background whenever Odoo sends an email through a server that has extra headers configured.
Depends on
Models and fields (1)
- ir.mail_server · extends an existing modelextra_headers
Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 1 confirmed, 8 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/mail.
terminal Installation and usage
OCA documentation · Odoo 18.0Configuration
Source · Odoo 18.0There's a new field in the Mail Server model: Extra Headers.
This field takes a Python dictionary expression as value, e.g. {"MY-HEADER": "test"}.
No verified information in OCA: Installation, Usage.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.