Skip to content

[FIX] mail: move subdomain DNS setup from website to inbound mail doc#18187

Open
jupe-odoo wants to merge 1 commit into
17.0from
17.0-update-subdomain-mailing-jupe
Open

[FIX] mail: move subdomain DNS setup from website to inbound mail doc#18187
jupe-odoo wants to merge 1 commit into
17.0from
17.0-update-subdomain-mailing-jupe

Conversation

@jupe-odoo

@jupe-odoo jupe-odoo commented Jun 1, 2026

Copy link
Copy Markdown

The inbound mail documentation referred to the subdomain-based method
as "MX record", which was too narrow and confusing. Both CNAME and MX
records are valid options, but CNAME is simpler to set up as it inherits
SPF and other DNS records from the target domain, avoiding extra
configuration for outbound mail authentication.

The setup instructions were also scattered across the website/domain_names
documentation, which is not where users configuring inbound mail would
naturally look.

In email_servers_inbound.rst, the section is renamed to "DNS records"
and consolidated with step-by-step instructions for both Odoo Online
and Odoo.sh, recommending CNAME while keeping MX as a noted alternative.
All cross-references in email_communication.rst, email_servers_outbound.rst,
and domain_names.rst are updated accordingly.

task-6191004

@robodoo

robodoo commented Jun 1, 2026

Copy link
Copy Markdown
Collaborator

Pull request status dashboard

@jupe-odoo jupe-odoo requested a review from Abridbus June 1, 2026 10:14
@C3POdoo C3POdoo requested review from a team June 1, 2026 10:50
Comment thread content/applications/general/email_communication/email_servers_inbound.rst Outdated
Comment thread content/applications/general/email_communication/email_servers_inbound.rst Outdated
@jupe-odoo jupe-odoo force-pushed the 17.0-update-subdomain-mailing-jupe branch from 0c43237 to 9ab9035 Compare June 1, 2026 12:09
@jupe-odoo jupe-odoo force-pushed the 17.0-update-subdomain-mailing-jupe branch from 9ab9035 to 15a9812 Compare June 4, 2026 08:15
@C3POdoo C3POdoo requested a review from a team June 4, 2026 08:23
@jupe-odoo jupe-odoo force-pushed the 17.0-update-subdomain-mailing-jupe branch 2 times, most recently from 9b56210 to 0df49ef Compare June 4, 2026 09:26
@AntoineVDV AntoineVDV requested review from a team and removed request for a team June 5, 2026 09:31
Comment thread static/css/odoo.css
Comment thread content/applications/websites/website/configuration/domain_names.rst Outdated
Comment thread static/css/odoo.css Outdated
Comment thread content/applications/general/email_communication/email_servers_inbound.rst Outdated
Comment thread content/applications/general/email_communication/email_servers_inbound.rst Outdated
Comment thread content/applications/general/email_communication/email_servers_inbound.rst Outdated
@jupe-odoo jupe-odoo force-pushed the 17.0-update-subdomain-mailing-jupe branch from 0df49ef to aea6877 Compare June 9, 2026 09:20
@jupe-odoo jupe-odoo changed the title [FIX] mail:move mailbox part domains to incoming mail doc [FIX] mail: move subdomain DNS setup from website to inbound mail doc Jun 9, 2026
@xpl-odoo xpl-odoo requested review from xpl-odoo and removed request for a team June 9, 2026 11:01
@jupe-odoo jupe-odoo force-pushed the 17.0-update-subdomain-mailing-jupe branch from aea6877 to 56de68b Compare June 19, 2026 14:54
The inbound mail documentation referred to the subdomain-based method
as "MX record", which was too narrow and confusing. Both CNAME and MX
records are valid options, but CNAME is simpler to set up as it inherits
SPF and other DNS records from the target domain, avoiding extra
configuration for outbound mail authentication.

The setup instructions were also scattered across the website/domain_names
documentation, which is not where users configuring inbound mail would
naturally look.

In email_servers_inbound.rst, the section is renamed to "DNS records"
and consolidated with step-by-step instructions for both Odoo Online
and Odoo.sh, recommending CNAME while keeping MX as a noted alternative.
All cross-references in email_communication.rst, email_servers_outbound.rst,
and domain_names.rst are updated accordingly.

task-6191004
@jupe-odoo jupe-odoo force-pushed the 17.0-update-subdomain-mailing-jupe branch from 56de68b to f0dd2e5 Compare June 19, 2026 15:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants