OdooWiki OCA HUB

Autogenerated headers

mail_autogenerated_header folder_open OCA/mail open_in_new
Tools License: AGPL-3

This module was written to mark Odoo's emails as being autogenerated according to RFC 3834, section 5. This allows receiving mail servers to act accordingly by for example not sending a vacation autoreply.

On the receiving side, this module drops all notifications for autogenerated incoming e-mails.

The combination of both avoids possible mail loops with misconfigured or broken email servers on the opposite side.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Marks Odoo's outgoing emails as autogenerated so other mail servers don't send vacation replies, and ignores incoming auto-replies to prevent mail loops.

This module changes how Odoo handles automatic emails in both directions.

On the outgoing side, when Odoo sends an email that is not a normal comment (for example a notification or a system message), it adds special technical headers to the message: Precedence set to bulk, X-Auto-Response-Suppress set to OOF and Auto-Submitted set to auto-generated. Receiving mail servers can read these headers and avoid sending automatic vacation replies back, which prevents mail loops.

On the incoming side, when an email arrives that looks like an automatic reply (it carries an Auto-Submitted header other than "no", or an X-Auto-Response-Suppress header containing AutoReply or All), Odoo logs it and stops all further notifications for that message. This means no new emails are generated in response, again avoiding loops.

The behaviour is controlled by a system setting stored as a configuration parameter named mail_autogenerated_header.allow_autogenerated_outgoing, which is enabled by default. It can be turned off to stop adding the outgoing headers. A context flag can also disable the headers for a specific send.

The module extends the mail server model ir.mail_server and the abstract mail thread model mail.thread. It does not add any new menu or screen; it works in the background.

Depends on

mail
Models and fields (1)
  • ir.mail_server · extends an existing model

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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 6 confirmed, 3 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 18.0

For sending outgoing emails, users can change the config parameter mail_autogenerated_header.allow_autogenerated_outgoing to False to avoid any outgoing emails being marked as autogenerated. For only avoiding in certain cases, developers can set the context flag mail_autogenerated_header_disable in calls to send_email in order to suppress adding any autogenerated headers.

For receiving incoming emails, developers can override the method _message_route_process_autoreply to fine tune dropping autogenerated mails per model.

No verified information in OCA: Installation, Configuration.

info

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.