The isitdns protocol
what:The isitdns protocol is a set of DNS names under isitdns.net that answer "is it DNS?" with records anyone can read with dig.
halves:The read surface carries the monitor's verdict as TXT records (help and isit also carry an A); the report channel answers with what reached isitdns's own name servers.
version:version 2.1, first published 2026-10-30, surface 8
author:Neal Shelton
| use | dig | label |
|---|---|---|
| before blaming DNS | dig +short isit.isitdns.net TXT | the verdict, stamped |
| which resolver reached us | dig +short whoami.probe.isitdns.net TXT | the address of the resolver that asked |
| whose network asked | dig +short who.probe.isitdns.net A | 192.0.2.1 Cloudflare, 192.0.2.8 Google Public DNS, 192.0.2.99 any other network |
| answered in our place? | dig +short canary.probe.isitdns.net A | 192.0.2.111, or not; a match does not say the path was clean |
| root key roll readiness | dig +short ksk.isitdns.net TXT | the public resolvers, counted by how they handle the root key |
| scripts and AI agents | any read-surface name | DNSSEC-signed, no web page |
The read surface is eight names directly under isitdns.net, and a version record at _isitdns, whose TXT records (and the A records of help and isit) carry the verdict the site shows, stamped with the time of its newest reading.
helpthe verdict sentence, the menu of names, the receipt line, the tokens; A: the word as a codeisitthe tokens, then the word; A: the word as a codewhyeach resolver that is not ok, or "all measured resolvers answering"kskthe root key roll board: which public resolvers trust which root keycloudflarethat resolver's line: status, latency, DNSSEC, then one string per address family and transportgooglethe same, for Google Public DNSquad9the same, for Quad9adguardthe same, for AdGuard DNS_isitdnsthe version record: v=isit1 surface=8 round=180 spec=https://isitdns.net/wiki/dig/ask-dns
Every name is <name>.isitdns.net, one TXT each, TTL 60 s; the version record caches longer. The zone is DNSSEC-signed. Every line describes isitdns's own probes, never your network; the help record's receipt line says so: "probe: ours not yours".
Each record is one or more strings; the fields below are what isit and the last string of help carry.
stateok,degraded,failingorstale: the word as a tokenbadresolvers failing from every probe that read themmeasuredresolvers with a verdictprobesprobes the verdict was read from; 0 when nothing was measuredseatsthe same count under its old name, served beside probes at surface 8asofthe newest reading behind the line, UTC, to the second; not the time the record was written
The word, and its code in the A record of help and isit:
127.0.0.2no(state=ok): no measured resolver is struggling127.0.0.3mostly(state=degraded): some resolvers are struggling127.0.0.4maybe(state=failing): half or more are down127.0.0.5no data(state=stale): no verdict
127.0.0.1 is never one of these codes. The addresses are loopback so a code is never a host to connect to (RFC 5782 section 2.1).
One question to isit.isitdns.net over DoH, and what came back, piece by piece.
$ dig +https @cloudflare-dns.com +short isit.isitdns.net TXT
"state=ok bad=0 measured=16 probes=3 seats=3 asof=2026-10-30T16:21:01Z" "no"
2026-10-30 16:24:33Z, a machine asking cloudflare-dns.com over DoH.
state=okthe word as a token: nobad=0no resolver failing everywheremeasured=1616 resolvers with a verdictprobes=3read from 3 probesseats=3the same count, old nameasof=2026-10-30T16:21:01Zthe newest reading, 212 s before the question"no"the word, the second string
$ dig +https @cloudflare-dns.com +short isit.isitdns.net A
127.0.0.2
2026-10-30 16:24:34Z, a machine asking cloudflare-dns.com over DoH.
127.0.0.2the code for no; read only beside a live TXT
$ dig +https @cloudflare-dns.com +short _isitdns.isitdns.net TXT
"v=isit1 surface=8 round=180 spec=https://isitdns.net/wiki/dig/ask-dns"
2026-10-30 16:24:34Z, a machine asking cloudflare-dns.com over DoH.
surface=8the version of the names and grammar on this pageround=180the shortest time between two changes to the zone, in seconds
label:live at capture, no
The same question from any machine, through its own resolver: dig +short isit.isitdns.net TXT.
A client is any program that turns these records into a verdict; these are the rules it follows.
- A client MUST join the strings of one record with nothing between them (as RFC 7208 section 3.3 does for multi-string TXT). In help each part is found by its prefix:
is it DNS?,ask:,receipt:,state=. - A stamp is live when -180 <= age < 600 seconds, age being the client's UTC clock minus the stamp; 1200 in place of 600 for ksk. A stamp that is not live is no data, whatever the word beside it says.
- The TXT wins. An A answer beside a TXT that is not live, or beside no TXT, is no data. A client MUST NOT connect to a code address, and MUST treat 127.0.0.1 or an address outside the four codes as not this protocol.
- A token line without
stateorasof, or with a key twice, is not usable. Unknown keys MUST be ignored. A word and astatethat disagree are no reading. - SERVFAIL, a timeout, REFUSED, NXDOMAIN, or NOERROR with no record for one of these names is no reading, never a verdict. More than one TXT, or more than one A, at one name is no reading.
- A
surfacethe client does not implement, or a version record that does not open withv=isit1, MUST NOT be turned into a verdict, and MUST NOT be reported as a DNS outage. - A client SHOULD validate the answer itself, or accept the AD bit only from a validating resolver it trusts over a secure channel (RFC 4035 section 4.9.3). A bogus answer MUST NOT be read as a verdict.
The grammar of every record, and a reader that uses exactly these bounds: asking DNS about isitdns.
The report channel is three names under probe.isitdns.net whose answer is made from the query that reached isitdns's own name servers.
canaryA 192.0.2.111, exactly; any other answer came from something answering in its place, or the zone was changedwhoA 192.0.2.1: the query came from Cloudflare's network; 192.0.2.8: from Google Public DNS's; 192.0.2.99: from a network with no published list. TXT src=<address> via=<cloudflare, google or none>whoamiTXT: the address the query came from
Each is <name>.probe.isitdns.net, DNSSEC-signed; who and whoami answer with TTL 0, so every query is read fresh. The addresses are documentation addresses (RFC 5737). A match says the query reached us from that network; it does not say the path was clean.
Two legs. Leg one is your device to its resolver, over port 53, DoT on port 853 or DoH on port 443, whichever your device is set to (RFC 1035 section 4.2, RFC 7858, RFC 8484). Leg two is the resolver asking isitdns's name servers, and it is the leg the report channel reads: it arrives on port 53, over UDP or TCP (RFC 7766 section 5), from the resolver's own address, whatever leg one was. So a device on DoT or DoH still gets a reading, and the address in it is its resolver's, not the device's.
What reaches the name servers. The address the question came from and the question with its flags; the network an address belongs to is looked up from the address. Not how your device reached its resolver, not your device's name, and not its address, except that some resolvers add a shortened client subnet (ECS, RFC 7871), which the answers here do not use.
The check-in. The path test (/tools/test-your-own-path) makes a fresh name and has you ask it once, so what arrives is your resolver's question and not a cache's answer. It reads back each arrival: which name server it reached, the address it came from, UDP or TCP, the RD, DO and CD bits, the EDNS buffer size, and the ECS prefix lengths, never the subnet itself.
$ dig +tls @1.1.1.1 +short whoami.probe.isitdns.net TXT
"104.22.26.111"
2026-11-03 11:55:05Z, a machine asking 1.1.1.1 over DoT.
label:Cloudflare's address, not the machine's
$ dig +https @cloudflare-dns.com +short who.probe.isitdns.net A
192.0.2.1
2026-10-30 16:24:34Z, a machine asking cloudflare-dns.com over DoH.
label:from Cloudflare's network
$ dig +https @cloudflare-dns.com +short who.probe.isitdns.net TXT
"src=172.71.29.237 via=cloudflare"
2026-10-30 16:24:34Z, a machine asking cloudflare-dns.com over DoH.
label:172.71.29.237, Cloudflare
$ dig +https @cloudflare-dns.com +short canary.probe.isitdns.net A
192.0.2.111
2026-10-30 16:24:34Z, a machine asking cloudflare-dns.com over DoH.
label:the reference answer
Not running today: the beacon, sessions, and a read-back of the transport and flags inside the answers of these three names (the path test reads them back for its own fresh names).
What a query to these names or a request to the site leaves with isitdns, every field and for how long, is on one page: /privacy.
This page is version 2.1 of the isitdns protocol, read surface 8, published from spec 2.1-draft at the commit below.
published2026-10-30, firstsurface8, as _isitdns.isitdns.net serves itspec commit32ad1fb7931aa5f344cbe7a25bf8fa979128ea1bbyNeal Shelton
Changes to the names, records and fields on this page, newest first. From 2026-10-14.
The read surface is surface 8, since 2026-10-06.
- 2026-10-30 · #404 · The protocol is published at /protocol, version 2.1.
- 2026-10-28 · #356 · The
_isitdnsrecord's spec= points to /wiki/dig/ask-dns. - 2026-10-27 · #348 · who.probe.isitdns.net answers with the network of the resolver that asked.