Use your own domain as an account handle
A custom-domain handle is a name you control, separate from your account's host. Verification must connect the domain to your existing DID in both directions.
By Link Jar. Updated 31 October 2026.
Does a custom domain move my account?
No. Changing the handle changes the account’s public name. The DID identifies the account, and its identity document identifies the host. A domain handle can remain yours when you change providers if you keep control of the domain.
For example, you.example.com can identify an account hosted elsewhere.
Do not create a new account merely to change the name of an existing one.
What does AT Protocol require?
The domain must resolve to your existing DID. The account’s identity document must also name that handle. The protocol supports a DNS TXT record or an HTTPS well-known file as proof of domain control.
Read the official handle specification for the exact domain rules and verification methods.
What works with linkjar.social today?
The current hosting implementation checks the HTTPS well-known file for external domain handles. A DNS-only recipe is not sufficient for this host at present. There is no custom-domain settings form documented here.
- Find your existing account’s DID in account settings.
- Serve that DID as plain text at
https://your-domain/.well-known/atproto-did. - Contact hello@linkjar.io for the supported authenticated handle-change procedure.
- Verify that the domain resolves to the DID and the identity document names the new handle.
Use the actual domain you control and your existing DID. Do not paste a password, provider token or Private Jar Recovery Kit into the public file. Other hosts may support a different verification path; follow their guidance.
What should I check before leaving a provider?
A name ending in a provider’s domain remains under that provider’s control. Check the destination’s handle requirements before moving. Keep the domain registration and verification file available for as long as you use the name. See account migration for the separate host-change steps.