Skip to Content
Q&A

Why Odoo emails do not arrive: SPF, DKIM, DMARC and where to look

A step-by-step way to find out whether the problem lies in Odoo, in your domain settings or at your mail provider

Back to all Q&A
November 4, 2026 by
Why Odoo emails do not arrive: SPF, DKIM, DMARC and where to look

In short: when an email from Odoo does not arrive, first check whether Odoo reports a failure. Then find out which mail route you use: Odoo's own server or an external one. On your own domain, SPF, DKIM and DMARC must be correct, and the sender address must match your outgoing mail server. This article gives you the order to check things in, for Odoo 19.

Email envelope travelling from a business system through a checkpoint on its way to an inbox

A customer says the invoice never arrived. Odoo shows that it was sent. Who is right? Both can be, and that is what makes this question so common in our helpdesk. Sending an email and delivering it are two different things, and several parties are involved between them.

This article is about diagnosis. If you want replies to land with a team instead of one person, read Sending emails centrally from Odoo.

Start with what you know

Odoo's documentation says clearly that Odoo is not a full email provider. Once a notification or transactional email has been sent successfully, the email object is deleted. Its content stays in the chatter of the record. So a message in the chatter proves it was written, not that it reached an inbox.

In practice there are three situations:

  • Odoo reports a failure. You can read the reason in Odoo. This is the easiest case.
  • The email is still waiting. It is in the queue and has not left yet.
  • Odoo reports nothing, but the recipient has nothing. The email may have been rejected or filtered later on. Odoo cannot always determine why, because mail providers apply their own policies.

Where to look in Odoo

  1. The red envelope in the chatter. This icon means sending failed for at least one recipient. Click it to see details. Where available, See Error Details shows more information.
  2. The email queue. Activate developer mode and go to Settings ‣ Technical ‣ Email: Emails. Failed emails have the status Delivery Failed. From here you can retry, send immediately or cancel an email.
  3. The logs. On Odoo.sh you can also check the logs for sending attempts and repeated failures.

Note that sent emails are periodically removed from the queue by the Auto-Vacuum scheduled action. An empty queue therefore says little about what happened last week.

Which mail route do you use?

The right fix depends on the route your email takes:

  • Odoo's server with an Odoo subdomain. By default, Odoo Online and Odoo.sh send from an address such as notifications@yourdatabase.odoo.com. SPF, DKIM and DMARC are already configured for these subdomains.
  • Odoo's server with your own domain. You send from your own address through Odoo. Then you need to add DNS records for your domain.
  • An external mail server. You send through your own provider. Odoo's DNS instructions do not apply: follow the instructions of that provider for SPF, DKIM and DMARC.

SPF, DKIM and DMARC in plain language

These three records tell receiving mail servers whether your email is genuine. You add them at your DNS provider, not in Odoo. The examples below apply to sending from your own domain through Odoo's server.

SPF: who may send

SPF is a TXT record listing the servers allowed to send for your domain. The test runs on the bounce address, which depends on the Alias Domain field in the General Settings. Without an SPF record, create this one: v=spf1 include:_spf.odoo.com ~all

Do you already have an SPF record, for example for your office email? Then add include:_spf.odoo.com to it. Do not create a second record, because that is one of the classic mistakes.

DKIM: a signature on the message

DKIM proves that a message was really sent on behalf of your domain and was not changed on the way. According to Odoo, it is required when you send from your own domain through Odoo's server. Add a CNAME record with the name odoo._domainkey pointing to odoo._domainkey.odoo.com.

DMARC: what to do when checks fail

DMARC links SPF and DKIM and tells the receiving server what to do with mail that fails. The policy p=none only collects reports. The policies p=quarantine and p=reject act on failures, so move to them only when your reports look clean. A starting point is a TXT record named _dmarc with the value v=DMARC1; p=none; rua=mailto:postmaster@example.com, using your own reporting address.

Passing DMARC does not guarantee delivery, because spam filters look at more than these records. For the wider picture, including DNSSEC and encryption, read A 100% score on internet.nl.

The sender address and the outgoing mail server

Many problems arise because the sender address does not fit the server. To use your own server, go to Settings, enable Use Custom Email Servers in the Emails section and save. Then open Outgoing Email Servers, click New, enter the details from your provider and click Test Connection. A successful test does not guarantee delivery, because the provider may impose further restrictions.

Next, set the FROM filter as your provider instructs. Odoo chooses a server in this order:

  1. A server whose FROM filter matches the full sender address or domain.
  2. Otherwise, the first server without a FROM filter, and the sender is replaced by the notification address.
  3. Otherwise, the first server, also with that replacement.

So if a recipient suddenly sees a notifications address as the sender, the filter is a likely reason. Three more things to check:

  • Port. On Odoo Online and Odoo.sh, port 25 is blocked. Use 465, 587 or 2525.
  • Verified sender. Providers may only accept addresses they know. A 550 error stating that the from address does not match a verified identity means that you need to adjust the address or have it approved by your provider.
  • The administrator's address. The default admin account has a placeholder email address. Odoo recommends replacing it to avoid problems with outgoing email.

Other common causes

  • The daily limit. The documentation mentions a default limit between 5 and 200 emails per day, depending on your subscription, your installed apps and whether a migration is in progress. Internal notifications sent by email count too. Letting colleagues receive notifications in Odoo reduces this.
  • Timing. The queue is processed by a scheduled action. By default this runs every 60 minutes, so a queued email may simply not have left yet.
  • Invalid addresses. Clean up addresses that bounce. Odoo notes that sending to invalid addresses or spam can harm the reputation of the sending server.
  • One customer or domain. If the problem only occurs with one recipient, ask them to check their spam filter. With recurring problems at one domain, Odoo Support can be consulted.

A test you can run today

  1. Pick one email that did not arrive and look it up in the chatter.
  2. Check the queue for its status and any error message.
  3. Write down the sender address that was used and determine the mail route.
  4. Check SPF and DKIM with a tool such as MXToolbox, which Odoo's documentation also mentions.
  5. Send a test email to Mail-Tester to check the complete setup.
  6. Change one thing at a time, then test again.

What this means for you

DNS changes are outside Odoo, so make sure you know who manages your domain before you start. If that is an external party, send them the exact records. Plan the work for a quiet moment too, and do not change an existing SPF or DMARC record without checking which other services send email from your domain. Your office email and marketing tools must keep working.

Frequently asked questions

Where can I see which emails failed in Odoo?

In the chatter you see a red envelope icon on a message that failed for at least one recipient. In developer mode you find the queue under Settings, Technical, Email: Emails. Failed emails have the status Delivery Failed there.

Do I need to set up SPF and DKIM if I send through Odoo?

On the default Odoo subdomain this has already been arranged. If you send from your own domain through Odoo's mail server, SPF and DKIM are necessary. If you use an external mail server, follow the instructions of that provider.

Has an email arrived if Odoo shows no error?

Not necessarily. Odoo cannot always determine why delivery failed, because mail providers have their own policies for bounce messages. According to the documentation, an incorrect SPF or DKIM setting is one of the most common causes of failures without an error message.

Finally

Reliable email starts with knowing which route your messages take. Want us to check your domain settings and outgoing mail with you? Contact DAADit Group, Odoo Silver Partner in Eindhoven, or start with the free Business Scan.

in Odoo

Question not answered?

Our Odoo consultants are happy to think along with you. Book a no-obligation intro call.

Book an appointment
Microsoft Teams from Odoo: calling from contacts, CRM and helpdesk, meeting from the calendar and appointments
How we built click-to-call and Teams meetings for Odoo 19, and what you need to arrange beforehand