Skip to content

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

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

[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
Contributor

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 2 times, most recently from 56de68b to f0dd2e5 Compare June 19, 2026 15:41
@Abridbus
Abridbus requested a review from mcsi-odoo July 24, 2026 15:28

@mcsi-odoo mcsi-odoo left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @Abridbus, I've put my suggestions and questions below, but it'd probably still be good to catch up in person 😄 Also, I noticed that the three new images still need to be compressed.

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
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 3 times, most recently from 8214229 to bf489d0 Compare July 30, 2026 13:07

@mcsi-odoo mcsi-odoo left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @jupe-odoo , thanks for take my feedback into account!
Just two small things from my side (removing one full stop, and scaling one image to 50%).
Otherwise, it's good for me, so I'll already delegate r+.

@robodoo delegate+

Cc: @Abridbus

Comment thread content/applications/general/email_communication.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
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 bf489d0 to e9c3d4f Compare July 31, 2026 06:25
@jupe-odoo

Copy link
Copy Markdown
Contributor Author

@robodoo r+

robodoo pushed a commit that referenced this pull request Jul 31, 2026
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

closes #18187

Signed-off-by: Julien Pendeville (jupe) <jupe@odoo.com>
@robodoo robodoo closed this Jul 31, 2026
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.

5 participants