This module allows companies working with multiple Operating Units to send emails with the appropriate email domain and, optionally, the appropriate outgoing mail server depending on the Operating Unit context.
It lets you define an Alias Domain on an Operating Unit and use that domain automatically when emails are generated from templates or records linked to that Operating Unit.
It also allows you to define an Outgoing Mail Server on an Operating Unit and automatically route emails through that server when no mail server is explicitly defined on the email template.
This is especially useful in multi-brand or multi-entity environments where each Operating Unit must send emails using its own domain and SMTP server, while still keeping the standard Odoo behavior as a fallback when no specific Operating Unit configuration can be determined.
auto_awesome What this module does
AI-generated from the code · Odoo 17.0Lets each Operating Unit use its own email domain and outgoing mail server, so emails sent from records or templates linked to that Operating Unit go out with the right identity.
This module connects Operating Units with email settings. On each Operating Unit you can now set an Alias Domain (the email domain used when sending) and an Outgoing Mail Server.
- On the Operating Unit form and list you get two new fields: Alias Domain and Outgoing Mail Server. You can also search and filter Operating Units by these values.
- On email templates you get an Operating Unit field, visible in the form, the list and the search filters (including a group-by).
- When an email template with an Operating Unit is used to send a message, the email is sent using that Operating Unit's Alias Domain.
- When an email is about to be sent and no mail server has been chosen yet, Odoo looks at the record's Operating Unit and uses its Outgoing Mail Server. If the record has several Operating Units, it uses the shared server when they all point to the same one, or the server of the user's default Operating Unit.
- If no Operating Unit or no server can be found, Odoo keeps its normal behaviour.
The module touches mail.mail, mail.template and operating.unit, and adds the Operating Unit field to outgoing mails.
Depends on
Models and fields (3)
- mail.mail · extends an existing modeloperating_unit_id (Operating Unit)
- mail.template · extends an existing modeloperating_unit_id (Operating Unit)
- operating.unit · extends an existing modelmail_server_id (Outgoing Mail Server), alias_domain_id (Alias Domain)
Text generated by AI (DeepSeek) from reading the Odoo 17.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 17.0
Confirmed on 2026-11-03 in branch 17.0 of OCA/operating-unit.
terminal Installation and usage
OCA documentation · Odoo 17.0Configuration
Source · Odoo 17.0To configure this module, you need to:
- Assign an Alias Domain to each Operating Unit that should use a specific email domain.
- Assign an Operating Unit to an Email Template when emails sent from that template must use the alias domain of that operating unit.
- Optionally assign an Outgoing Mail Server to an Operating Unit when emails should be routed through a specific SMTP server.
When no operating unit is defined on the template or on the target record, the standard Odoo alias domain behavior is applied.
When no unambiguous Operating Unit mail server can be determined, the standard Odoo outgoing mail server selection is applied.
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.