How to Set a Custom Domain on Bluesky
Setting a custom domain on Bluesky lets you use your own website address (like alex.example.com) as your handle, replacing the default @username.bsky.social. It adds a professional touch and makes your profile easier to find and remember. This guide walks you through the process, which involves adding a DNS record through your domain registrar and then verifying it in Bluesky.
What You’ll Need
- A Bluesky account (free or paid).
- A domain name you control, with access to its DNS settings (usually through your domain registrar or hosting provider).
- Ability to create a new DNS record (TXT record) for that domain.
Step-by-Step
- Log in to Bluesky on the web at bsky.app (or open the mobile app). Go to your profile by clicking your avatar in the top-right corner, then select Settings.
- In Settings, find the Account section and click on Handle (or “Change handle”). This opens the handle change dialog.
- Choose the option that says “I have my own domain” (or “Use a domain I own”). Bluesky will show you a DNS record that you need to add. It looks like a TXT record with a name like
_atprotoand a value that starts withdid=. - Copy the exact DNS record details shown. You’ll need the host/name (e.g.,
_atproto) and the TXT value (e.g.,did=did:plc:abcdefg...). Keep this window open or copy the info to a note. - Go to your domain registrar or DNS provider (like Namecheap, GoDaddy, Cloudflare, or your web host). Log in and navigate to the DNS management page for the domain you want to use.
- Create a new TXT record with the details you copied. Usually you’ll click “Add Record” or “Add New Record,” select type TXT, enter the host name (often just
_atprotoor the full subdomain if required), and paste the TXT value. Save the record. - Wait for DNS propagation. This can take from a few minutes to up to 48 hours, though it’s often quicker (minutes to an hour).
- Return to Bluesky and click the button that says “Verify DNS” or “Check.” Bluesky will check if the TXT record exists. If it does, you’ll see a confirmation and can click “Save” or “Update handle.”
- Your profile handle will now show as @yourdomain.com (or the subdomain you used, like @user.yourdomain.com). You’re done!
Common Mistakes
- Using the wrong host name: Some registrars automatically append your domain to the host field. If you enter
_atprotoand the system turns it into_atproto.yourdomain.com, that’s correct. But if you enter the full_atproto.yourdomain.comand the system appends again, you’ll get_atproto.yourdomain.com.yourdomain.com– which won’t work. - Copying the TXT value with extra spaces or line breaks: Make sure you paste the exact value, without any extra characters.
- Choosing a subdomain that’s already in use: If you use
wwwor another subdomain that has other DNS records, it might conflict. It’s safer to use a unique subdomain likeuserorbsky. - Not waiting long enough: DNS changes can take time. If verification fails, wait a bit and try again.
- Using the wrong domain: Double-check that you’re adding the record to the correct domain – the one you want as your handle.
Tips
- Use a subdomain if you want to keep your main domain clean. For example,
bsky.yourdomain.comis a common choice. It doesn’t affect your website’s existing DNS. - Keep your DNS records organized. If you manage multiple domains, label the TXT record clearly (e.g., “Bluesky verification”).
- Test your handle after changing. Post a message and check that your profile shows the new handle correctly.
- If you later change your domain, you’ll need to add a new TXT record for the new domain and verify again.
Troubleshooting
Verification fails immediately: Wait 10–15 minutes and try again. DNS propagation can be slow. If it still fails, check that you entered the record exactly as shown, including the underscore in the host name.
You see “Record not found” but you added it: Use a DNS lookup tool (like dnschecker.org) to see if the record is visible globally. If it shows, but Bluesky still says no, try clearing your browser cache or using a different browser.
You get an error about the host name: Some providers require you to enter the full domain (e.g., _atproto.yourdomain.com) instead of just _atproto. Check your provider’s help docs.
You changed the handle but it still shows the old one: Log out and log back in, or refresh your profile. Sometimes the app caches the old handle.
You want to revert to the default handle: Go back to Settings > Handle, and choose the option to go back to @username.bsky.social.
Frequently Asked Questions
Do I need to pay for a custom domain on Bluesky?
No, Bluesky doesn’t charge extra for using a custom domain. You only pay for the domain itself (if you don’t already own one).
Can I use a subdomain like blog.example.com?
Yes, you can use any subdomain you own. Just make sure you add the TXT record to that specific subdomain (e.g., _atproto.blog).
Will my old @username.bsky.social handle stop working?
No, your old handle will still work as an alias. People can still find you by your old handle, but your profile will display the custom domain.
How long does it take for the DNS record to be recognized?
It varies. Usually it’s within an hour, but it can take up to 48 hours in rare cases. You can check propagation with online tools.
Can I use a custom domain if I have a free Bluesky account?
Yes, custom domains are available to all users, free or paid.
What if I don’t own a domain? Can I still get one?
Yes, you can buy a domain from any registrar. Prices vary, but you can find domains for as low as a few dollars per year.
Related
Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.