Bluesky DID Finder
A free tool to resolve Bluesky handles to permanent Decentralized Identifiers (DIDs).
Bluesky DID Finder
Enter a handle to resolve the decentralized identity.
How to Use the Bluesky DID Finder?
Enter a valid Bluesky handle such as username.bsky.social or a custom domain handle. The tool will instantly return the associated permanent DID used by the AT Protocol.
Why Handles Are Not Enough on Bluesky
Bluesky is built on the AT Protocol, a decentralized identity system where user identity is separated from usernames. Unlike traditional social platforms, your handle is not your true identity.
- Handle (@name.bsky.social): Human-readable and changeable. Users can rename themselves or switch to custom domains at any time.
- DID (did:plc:...): Immutable and permanent. This identifier never changes, even if the handle, profile, or hosting server changes.
If you build apps, bots, feeds, or moderation tools, you must rely on the DID. Hardcoding handles will eventually break your application.
Understanding DID Formats: did:plc vs did:web
did:plc
The most common format used by Bluesky accounts. It is registered in a transparency log that enables account portability across servers.
Example:
did:plc:ragtjsm2j2vknwkz3zp4oxrd
did:web
Typically used by self-hosted or organizational accounts. The DID is tied directly to a web domain and verified through HTTPS.
Example:
did:web:example.com
Common Use Cases
API Development & Feed Generation
AT Protocol endpoints work best when queried using DIDs. This avoids additional handle resolution and prevents errors if a user changes their username.
Moderation and Blocklists
Blocking by handle is ineffective. Blocking a DID permanently blocks the account, regardless of future handle changes.
Verifying Custom Domains
Comparing DIDs allows you to confirm that a new domain-based handle belongs to the same account as the previous username.
Frequently Asked Questions
Does a Bluesky DID ever change?
No. A Bluesky DID is designed to be permanent. Even if the user changes their handle, profile information, or hosting server, the DID remains the same.
Can I find a user's handle if I only have their DID?
Yes. The AT Protocol allows reverse resolution from a DID to the currently active handle. Since handles can change, the result reflects the current state only.
Why do I get an "Error: Handle not found" message?
This can happen if the handle is misspelled, the account has been deleted, or the account exists on a federated server that is not yet indexed by the public directory.
Is this Bluesky DID Finder safe to use?
Yes. This tool only queries publicly available identity records. It does not require login credentials and does not access private data.