Skip to content
AdminKit

Extended DNS Error (EDE)

What is Extended DNS Error (EDE)?

Extended DNS Error (EDE), an EDNS0 option defined in RFC 8914, lets a DNS server attach a machine-readable code explaining why it answered the way it did, instead of a bare SERVFAIL or NXDOMAIN. AdminKit's DNS lookup tool shows the answers an EDE code would explain, turning an opaque failure into a reason an administrator can act on.

By AdminKit team, Netbase JSC · Updated

Extended DNS Error (EDE) is an EDNS0 option (EDNS0 itself defined in RFC 6891), defined in RFC 8914 (document record at the IETF Datatracker), that lets a DNS server attach a machine-readable numeric code and short text to a response explaining why it answered the way it did, rather than leaving a client to guess from a bare SERVFAIL or NXDOMAIN. Codes distinguish causes that previously all looked identical from outside — a DNSSEC signature that’s expired (code 6), a name blocked by local policy (code 15), or a forwarder unable to reach its own upstream (code 22) — so a filtering or validating resolver can report the actual reason instead of an opaque failure. Resolver support depends on software and version: Unbound adds Extended DNS Error codes only when its ede option is enabled, while PowerDNS Recursor added an extended-resolution-errors setting in version 4.5.0 and enabled it by default from version 5.0.0, attaching an EDE to responses when resolution fails, such as on DNSSEC validation errors. IANA maintains the full list of assigned EDE codes in its DNS Parameters registry, the same registry that tracks EDNS0 option codes and other DNS protocol values. This matters most for resolvers that intentionally withhold an answer, such as a DNSSEC-validating resolver rejecting a forged response or a protective DNS service blocking a known-malicious domain, where EDE turns a bare failure into a reason an administrator can actually act on; protective DNS for small business shows how to read it when testing a blocking resolver. See the EDNS0 entry for the extension mechanism EDE, DNS Cookies and ECS all build on.

Extended DNS Error (EDE) is part of AdminKit’s DNS cluster; the full AdminKit glossary lists other related terms.

Frequently asked questions

What problem does Extended DNS Error solve?

It replaces a bare SERVFAIL or NXDOMAIN with a machine-readable numeric code and short text explaining the actual reason a server answered that way.

Which EDNS0 option is EDE built on?

EDE is itself an EDNS0 option, so it rides on the same extension mechanism RFC 6891 defines rather than changing the core DNS message format.

What's an example of a specific EDE code?

Code 6 means an expired DNSSEC signature, code 15 means a name blocked by local policy, and code 22 means a forwarder couldn't reach its own upstream.