2 min read

Setting up a Bluesky custom domain handle on Netlify

Photograph of two birds flying through a clear blue sky
Photo by hiva sharifi / Unsplash

So you just started your Bluesky journey, huh?

And maybe you want to setup your own ✨fancy✨ custom domain handle (for example, mine is @cecy.ai).

Well, if you have a Netlify site, and you also bought your domain on Netlify, here's how you can set up your custom domain name on Bluesky:

This should apply to anyone who wants to setup a custom domain as a handle on Bluesky, BUT Steps 5 - 9 apply only if you have a domain you bought through Netlify.

  1. Open the Bluesky app, and go to Settings (by opening the menu on the left-hand side)
  2. Scroll down and click on "Change Handle"
  3. Now click on "I have my own domain"
Bluesky Change Handle screenshot
  1. Enter the domain you want to use at the top, then click on "Copy Domain Value"
Bluesky app screen showing custom domain settings to change your handle
  1. Now go to your Netlify dashboard, and click on Domains
Netlify dashboard screenshot showing list of domains
  1. Click on the domain you want to use as your Bluesky handle
  2. Under "DNS Settings" > "DNS Records", click on "Add new record"
  3. With the value you copied from Bluesky, select the following settings for your DNS Record:
    Record type: TXT
    Name: _atproto
    Value: WHAT YOU COPIED FROM BLUESKY (starts with did=)
Netlify DNS Record screenshot showing settings to setup Bluesky _atproto example
  1. Click Save
  2. Go back to Bluesky, wait a little bit, then click on "Verify Domain"

If all looks good, you should see this screen:

Bluesky screenshot showing a Domain has been successfully verified.

🥳 Congrats! You just setup your custom domain handle on Bluesky!

Published by:

Cecy Correa