bsky-handle.md - is-a-dev-docs - is-a.dev Documentation

bsky-handle.md (1368B)
      1 ---
      2 order: 200
      3 icon: /media/bluesky.svg
      4 label: Bluesky Custom Handle
      5 tags: guides
      6 ---
      7 
      8 # Setting up a Bluesky custom handle with an is-a.dev subdomain
      9 
     10 ## Get your verification string
     11 
     12 1. Open your Bluesky app and go to your profile **Settings**.
     13 
     14    ![](../media/bsky/step_1.png)
     15 
     16 2. Open the **Accounts** page.
     17 
     18    ![](../media/bsky/step_2.png)
     19 
     20 3. Go to the **:icon-mention: Handle** settings.
     21 
     22    ![](../media/bsky/step_3.png)
     23 
     24 4. Click on the "I have my own domain" button.
     25 
     26    ![](../media/bsky/step_4.png)
     27 
     28 5. **Enter** your is-a.dev subdomain name in the text input and then **Copy** the TXT string. (e.g. `your-subdomain.is-a.dev`).
     29 
     30    ![](../media/bsky/step_5.png)
     31 
     32 
     33 ### Create your domain file
     34 
     35 Create a JSON file inside the `domains/` directory called `domains/_atproto.your-subdomain.json` with the following content and open a pull request:
     36 
     37 ```json
     38 {
     39     "owner": {
     40         "username": "your-github-username"
     41     },
     42     "records": {
     43         "TXT": "bsky-verification-string"
     44     }
     45 }
     46 ```
     47 
     48 > [!NOTE]
     49 > Don't forget the comma right above the `"records"` key!
     50 
     51 ## Configuration
     52 
     53 After your pull request has been merged, repeat steps 1-5 and press the `Verify DNS Record` button.
     54 If it shows any error such as `Failed to verify handle. Please try again.`, try waiting a few minutes (sometimes up to 24 hours) as the DNS records may not have propagated yet.