Bluesky custom domain handle: get the TXT record and check it
Your handle will be @jake.example.com
Bluesky shows it in Settings, Account, Handle, I have my own domain, DNS Panel. The sample is not a real account.
Add this TXT record at your DNS host
| Type | TXT | |
|---|---|---|
| Name / Host | _atproto.jake | |
| Full name | _atproto.jake.example.com | |
| Value | did=did:plc:ewvi7nxzyoun6zhxrhs64oiz |
Use Name / Host if your DNS host adds the main domain for you (Cloudflare, Namecheap, GoDaddy). Use the full name if it expects the whole thing. Add quotes around the value only if your host asks.
Your domain and DID stay in this page. The only request sent is a public DNS lookup of the _atproto name to Cloudflare or Google when you press Check.
How to use it
- In Bluesky, open Settings, Account, Handle, and choose I have my own domain. Copy your DID from the DNS Panel.
- Type the domain you want as your handle above. A subdomain such as jake.example.com works as well as a root domain.
- Create the TXT record shown at the company that hosts your DNS. Paste the Name / Host and Value exactly.
- Press Check if it is live. When it shows Live, go back to Bluesky and press Verify DNS Record.
If the check does not pass
- No record found: DNS changes take a few minutes to an hour. Confirm the record is saved on the DNS host that your nameservers point to.
- Doubled domain: if the host adds your domain automatically, use the short Name / Host, not the full name, or you get _atproto.example.com.example.com.
- Wrong value: the value must start with did= and contain nothing else. Paste it without extra spaces or line breaks.
- Two did= records: Bluesky wants exactly one per name. Delete the old one. Other TXT records on the same name are ignored.
- Rejected domain: handles under .test, .local, .example, .internal, .onion and a few other reserved endings never resolve, and the last part of the domain cannot start with a number.
- Cannot use TXT: Bluesky also accepts a file at https://yourdomain/.well-known/atproto-did containing only the DID.
Questions
Where do I find my DID?
In the Bluesky app or site, open Settings, Account, Handle, choose I have my own domain and open the DNS Panel. It shows your DID and the record Bluesky expects.
What is the exact TXT record for a Bluesky handle?
The name is _atproto followed by your handle domain, and the value is did= followed by your DID, for example did=did:plc:ewvi7nxzyoun6zhxrhs64oiz. Add it as a TXT record.
Can I use a subdomain like name.example.com as my handle?
Yes. Make the record for _atproto.name.example.com. That leaves your main domain free for a website, and you do not need to own a root domain by itself.
How long until Bluesky sees the record?
Often under five minutes, sometimes an hour or more depending on your DNS host and its TTL. If you checked before the record existed, resolvers may remember the empty answer for a while, so wait a few minutes between checks. Use the check button to watch for it before you press Verify in Bluesky.
Will changing my handle break my followers or posts?
No. Your account is tied to your DID, not the handle, so followers, posts and links to your profile by DID keep working. Only the visible @name changes.