← Back to Tutorials

Bluesky Handle Setup

Set Your Handle to GitHub Pages

Follow these simple steps to set your Bluesky handle to your GitHub Pages subdomain (e.g., your-username.github.io):

1

Open Bluesky Settings

  • Click your profile picture and go to "Settings"
  • Scroll to "Advanced" → "Change handle"
2

Enter Your Subdomain

  • Choose "I have my own domain", select "No DNS Panel", and type your subdomain like your-username.github.io
  • Bluesky will give you a verification code
3

Create a .well-known Folder

  • In your GitHub repo, create a folder called .well-known in the root (if it doesn't already exist)
4

Create the Verification File

  • Inside .well-known, make a file named atproto-did
5

Paste the Verification Code

  • Open the file and paste your code like this:
did:plc:YOUR_VERIFICATION_CODE
6

Push to GitHub

  • Save and push your changes to GitHub
  • Make sure it's live at:
https://your-username.github.io/.well-known/atproto-did
7

Verify It on Bluesky

  • Back in Bluesky, click "Verify Text File"
  • It'll check and confirm your domain

Result

Once verified, your handle will be set to your GitHub Pages subdomain: @your-username.github.io