Go to the website

Troubleshooting Bluesky Connection: Switching to a Domain-Based Handle

If you have experienced "Connection Error: Password not yet active" or "Invalid Identifier" errors when connecting your Bluesky account, switching to a domain-based handle is the most reliable solution.

Why You Should Verify Your Domain on Bluesky

While the default @username.bsky.social handle works for most, using your own domain (e.g., @yourbrand.com) bypasses synchronization delays and API resolution errors that can plague third-party integrations.


The Benefits of a Custom Handle

  • Instant Brand Recognition: Your followers see your official website URL as your handle, instantly identifying you as the "real" account.

  • Built-in Verification: Since only the domain owner can set a custom handle, it serves as a free "blue checkmark" of authenticity.

  • Portability: If you ever move your data to a different server within the AT Protocol, your identity (your domain) stays exactly the same.

  • API Stability: Professional social media tools like ours can resolve custom domains more consistently than generic handles during high-traffic periods.


Step-by-Step: How to Convert Your Handle

1. Access Handle Settings

  • Log in to your Bluesky account via the web browser or mobile app.

  • Navigate to Settings > Account > Handle.

  • In the pop-up window, click the link at the bottom: "I have my own domain."

2. Generate Your Unique Verification Code

  • Enter the domain you wish to use (e.g., yourbrand.com).

  • Bluesky will generate a TXT Record for you. Keep this window open, as you will need to copy the Value (which looks like did=did:plc:abc123...).

3. Update Your DNS Settings

  • Log in to your domain registrar or hosting provider (e.g., GoDaddy, Cloudflare, DigitalOcean, or Namecheap).

  • Go to the DNS Management or Networking section for your domain.

  • Add a New Record with these specific details:

    • Type: TXT

    • Host/Name: _atproto

    • Value/Data: (Paste the did=did:plc:... string you copied from Bluesky)

    • TTL: Default (usually 3600 or 1 hour)

  • Save the changes.

4. Finalize Verification

  • Return to the Bluesky settings window.

  • Click "Verify DNS Record."
    Note: DNS changes can sometimes take a few minutes to propagate. If it doesn't verify immediately, wait 60 seconds and try again.

  • Once verified, click "Update to [[suspicious link removed]]".


Alternative: Verification via Web Host

If you do not have access to your DNS settings, you can verify via your website:

  1. In the Bluesky handle settings, click "No DNS Panel? Use a text file."

  2. Download the provided file or copy the text.

  3. Upload it to your server at: https://yourdomain.com/.well-known/atproto-did.

  4. Click "Verify Text File" in Bluesky.


Troubleshooting the Connection

Once your handle is updated to your custom domain, return to Account/Workspace Preferences and attempt the connection again using your new handle and a freshly generated App Password. The "Password not yet active" error should now be resolved.

👆 You’re all caught up