Something not working?

What should I include in a bug report?

On a Mac, open Settings › Advanced. What this Mac reports lists the resolver in use, its addresses, the network service DNS Button configures and the app version. On iPhone and iPad, the resolver and its addresses are on the Details page under the button, and the version is in Settings › About. Paste those into an email to support@dnsbutton.dev, with your macOS or iOS version and what you expected to happen.

Usually not a bug

Why does DNS Button say a provider I did not pick?

That's the app doing its job. On a Mac it reads your DNS back from the system every time the menu opens, so when a VPN, a configuration profile or another app takes over, the menu tells you. If it doesn't recognize the resolvers, it says Unrecognized instead of guessing.

Why is the button at the top of the menu grayed out?

There's nothing for it to turn on yet. Pick a provider from the list and the button is ready to use.

Why does a resolver show no response time, or time out?

Some networks block DNS to anything but their own resolver, and some resolvers don't answer from every country. A timeout is a real result about your network, not a broken test.

Why hasn't a resolver I added shown up on my other devices?

Resolvers sync through iCloud to devices signed in to the same Apple Account, with iCloud turned on for DNS Button. Only the resolvers you add sync, not settings or network rules.

How do I report a security issue?

Email support@dnsbutton.dev with security in the subject, and please don't post about it publicly first. I'll confirm I got it, tell you what I find, and credit you if you'd like.

How do I get a refund?

Purchases go through Apple, so refunds do too, at reportaproblem.apple.com. I can't issue one directly. If something's broken, tell me anyway so I can fix it.