Fix SPF Include Not Found and Void Lookups

Why a missing include: or redirect= target, or more than two void DNS lookups, makes SPF return permerror, how to find the broken term, and how to fix typo includes, retired vendors and empty exists lookups.

Home › Guides › SPF include not found / void lookups

Last updated 17 November 2026

Quick answer

Two different RFC 7208 rules produce an SPF permerror when DNS comes back empty. They are easy to confuse.

  1. A missing SPF record at an include: or redirect= target is immediately a permerror. Section 5.2's table says a recursive check_host() result of none causes the include mechanism to return permerror (and that fails the whole evaluation). Section 6.1 says that if a redirect= target has no SPF record, the result is permerror rather than none. One typo, one retired vendor include, or one redirect to a name you never published is enough.
  2. More than two void lookups is also a permerror. Section 4.6.4 says implementations should limit "void lookups" to two, and that exceeding the limit produces permerror. A void lookup is a DNS query for a term that returns either a Name Error (NXDOMAIN, RCODE 3) or a successful response with zero answers (RCODE 0, empty). That budget is for the whole evaluation, including nested includes, not two per include.

Run the domain (or a draft record) through the SPF Record Checker. It expands every include and redirect, flags void lookups, and reports when the void count goes over two. This is a different failure from going over 10 DNS lookups, which is also a permerror.

What "include not found" actually is

include:vendor.example does not paste that vendor's mechanisms into your record. It runs a full SPF evaluation of vendor.example and, if that evaluation returns pass, your include matches. RFC 7208 section 5.2 is explicit about the other outcomes:

Recursive resultWhat the include does
passMatch (your include succeeds).
fail, softfail, neutralDo not match; evaluation continues with the next term.
temperrorThe whole evaluation returns temperror.
permerrorThe whole evaluation returns permerror.
none (no SPF record at the target)The whole evaluation returns permerror.

So a name that exists in DNS but has no v=spf1 TXT record, or a name that does not exist at all, is not a harmless miss. Receivers stop and return permerror, and DMARC treats that as an SPF fail. Common ways to get there:

The TXT lookup for your own top-level record is a different case: if that lookup finds no v=spf1 record, RFC 7208 section 4.5 returns none, not permerror. Two v=spf1 records at the same name are permerror.

What counts as a void lookup

RFC 7208 section 4.6.4 (which points at section 11.1) defines void lookups as terms whose DNS queries return:

The terms that cause DNS queries, and can therefore consume the void budget, are include, a, mx, ptr, exists and redirect. ip4, ip6 and all do not. Nested includes count. A third void lookup should produce permerror. The RFC says implementations may make the limit configurable, with a recommended default of two, so you should treat two as the budget you design for.

Void lookups often come from:

If the include target exists and returns other TXT records but no SPF record, that TXT query may not be void (it did return answers), but the include still permerrors because the recursive result is none.

How to find the broken term

  1. Paste the domain, or a draft record, into the SPF Record Checker. Read every ERROR first. The checker labels void lookups and raises an error when the count goes over two. It also flags a missing include or redirect target as it walks the tree.
  2. Look up the suspect name directly with the DNS Lookup tool: a TXT query should show a single v=spf1 record for an include or redirect target. NXDOMAIN, or TXT records that do not start with v=spf1, is the problem.
  3. After a DNS change, confirm more than one public resolver sees the new record with the DNS Propagation Checker.
  4. If DMARC reports show spf=permerror for a domain you own, open them in the DMARC Report Analyzer and fix the record before you tighten policy.
  5. On a received message, the Email Header Analyzer will show spf=permerror in Authentication-Results. That tells you the evaluation failed; the checker tells you why.

How to fix it

Do not flatten a vendor include just to hide a missing target. If the vendor's record is gone, flattening an old snapshot will authorize the wrong hosts. Remove or replace the include.

Verify the fix

  1. The SPF Record Checker should expand the tree with zero ERROR lines and at most two void lookups (ideally zero).
  2. Public resolvers should show one v=spf1 record on the DNS Propagation Checker.
  3. Send a new test message and confirm spf=pass in the Email Header Analyzer.
  4. Check MX and the rest of the domain on the MX Record Lookup and Email Deliverability Checker.

Audit hundreds of domains at once

Need SPF, DMARC and MX checks across a whole client list? Run the Bulk SPF / DMARC / MX Auditor on Apify ($2 per 1,000 domains).

Related tools and guides

Expand the live or draft record with the SPF Record Checker, rebuild it with the SPF Record Builder, and confirm publication with DNS Lookup and the DNS Propagation Checker. See the effect on a message in the Email Header Analyzer and on the domain in the Email Deliverability Checker. Related guides: SPF too many DNS lookups, SPF for Microsoft 365, Microsoft 365 inbound SPF softfail or permerror and DMARC p=none to p=reject rollout.

FAQ

Does one missing include always cause SPF permerror?

Yes. RFC 7208 section 5.2 says that when the recursive check of an include target returns none (no SPF record), the include mechanism returns permerror, and that ends evaluation of your record. The same is true of a redirect= target with no SPF record (section 6.1). You do not have to wait for three empty lookups.

What is a void lookup in SPF?

A DNS query made for an SPF term that returns NXDOMAIN, or a successful response with no answers. RFC 7208 section 4.6.4 says implementations should allow at most two such lookups in the whole evaluation, and that a third is a permerror. include, a, mx, ptr, exists and redirect can produce them; ip4, ip6 and all cannot.

Is this the same problem as too many DNS lookups?

No. The ten-lookup cap counts every include, a, mx, ptr, exists and redirect, whether or not they return data. The void limit counts only the ones that return no data, and the budget is two. Either condition is a permerror. A record can fail one, the other, or both.

Why did mail start failing after we removed a vendor?

If you removed the vendor's hosts but left include:their-domain in your record, and they later deleted their SPF record or the hostname, receivers now get none on that include and return permerror for every message from your domain. Delete the unused include as soon as the vendor stops sending.

Can I test a replacement record before publishing it?

Yes. Paste the new record into the optional box on the SPF Record Checker. It will expand includes, count lookups and flag void lookups without touching DNS at your domain. When the draft is clean, publish one TXT record and confirm it with the DNS Propagation Checker.

Want the full kit?

Runbooks, checklists and helpdesk templates: IT Admin Packs on Gumroad.