Start your free 30-day Enterprise trial. Sign up in seconds & unlock superior performance today. Get more details!

Guides & Tutorials

How to Change Your Bluesky Handle to Your Custom Domain with Netlify

Guides & Tutorials

How to Change Your Bluesky Handle to Your Custom Domain with Netlify

Let’s face it. One of the biggest headaches about social media is finding out that someone decided to squat on your desired username.

The dreaded “username has already been taken” error message

And while it would be one thing if people were genuinely using the account, the frustrating part is that more often than not, people:

  • Squat popular usernames for profit or in bad faith (also known as domain squatting)
  • Had the best of intentions with using it, but lose interest after a few days and the account sits completely unused

The issue of identity and verification has been a tricky one; but Bluesky, an up and coming social media platform, implemented a simple and elegant solution to this problem: use your custom domain as your username.

After all, as aptly paraphrased from this tweet:

Bluesky: "Hey Companies, do you have anything that uniquely identifies you online?"

Companies: "We own our own domains."

Bluesky: "Let's just use that.”

So, in this blog post, I’ll be showing how you can update your Bluesky handle to leverage your custom domain with Netlify.


Before we get started, here are the things you’ll need to have to follow along:

With that, let’s jump right in!

Step 1. Get DNS record information from Bluesky

The first thing we need to get is to inform Bluesky of our intent to use a custom domain and grab the necessary credentials. Here are the steps you’ll need to take to:

  1. Visit the “Settings” section in Bluesky
  2. Click on “Change my handle”

Screenshot of Bluesky’s web app (beta) that shows how to access change my handle option.

  1. Click on “I have my own domain” at the bottom of the prompt.

Screenshot of Bluesky’s web app (beta) that shows where the custom domain link is

  1. Enter your desired custom domain in this text input.

Screenshot of Bluesky’s web app (beta) that shows where users add the custom domain they want to use

Once you’ve added your custom domain (e.g.,, the Domain value will update to the correct relevant value (e.g.,

Screenshot of Bluesky’s web app (beta) that shows an updated DNS record with your custom domain

Now that we have this information, it’s time to move on to next step!

Step 2. Add Bluesky DNS record to Netlify

Now that we have the necessary information from Bluesky, it’s time to login to Netlify so we can configure out domain to verify that we own it. Once you’ve navigated to your site on Netlify which uses your desired custom domain, you’ll want to follow the following steps:

  1. Access the “Domain Settings” for the site that’s connected to the desired custom domain

Screenshot of Netlify dashboard that shows an example of where “Domain Settings” is

  1. Open the dropdown next to your domain name and click on “DNS panel”

Screenshot of Netlify dashboard that shows how to access the DNS panel for a custom domain

  1. Click on “Add a new record”

Screenshot of Netlify dashboard that shows how to start the process of adding a new record

Now that you see the new DNS record form, it’s time to grab that information we got from Bluesky in step 1!

Screenshot of Netlify dashboard that shows the new DNS record form

# Example data from Bluesky

  Type: TXT
 Value: did=did:plc:ebrgxjbu6rhgvigjlxlo3c4y

Unfortunately the information from Bluesky don’t completely match the form for Netlify DNS records, so here’s a quick reference on how the two correspond to one another:

  • DomainName
  • TypeRecord type
  • ValueValue

With that understanding, now you’re ready to:

  1. Fill out the form using the information from Bluesky

Screenshot of Netlify dashboard that shows a populated new DNS record form

  1. Verify that your new DNS record from Bluesky shows up in your dashboard.

Screenshot of Netlify dashboard that shows the new text record in the dashboard

Now that we see it in the dashboard, this will kick off a process to update the servers to have this new record. However, please note that the time it’ll take for the change to propagate can vary. My change happened within a few minutes, but it can take up to a day or so in some cases.

Step 3. Verify the DNS record on Bluesky

Once you’ve finished adding a record, it’s time to:

  1. Verify the DNS record on Bluesky.

Screenshot of Bluesky dashboard that shows how to verify the DNS record we just created

Assuming all the changes have propagated already, you will now see your shiny new handle that’s your custom domain! 🎉

Next steps

Congratulations! You’re now empowered to create all the properly branded Bluesky accounts without the anxiety of someone squatting your desired handle for your side project. 🙌

If you’d like to learn more about managing custom domains with Netlify, be sure to check out these resources:

Thanks for reading and I’ll see you over on Bluesky!

Keep reading

Recent posts

Book cover with the title Deliver web project 10 times faster with Jamstack enterprise

Deliver web projects 10× faster

Get the whitepaper