Threads Fediverse Username Format: at-handle Versus Webfinger Notes
🔍 WiseChecker

Threads Fediverse Username Format: at-handle Versus Webfinger Notes

When you share your Threads posts to the fediverse, your username appears in two different formats depending on where someone views your profile. The at-handle format is the one you see inside Threads itself, while the Webfinger format is the one used by Mastodon and other ActivityPub servers to find your account. These two formats look different and serve different purposes, which often confuses users who expect a single universal identifier. This article explains what each format is, how they relate to each other, and how to use them correctly when sharing your Threads profile with people on other fediverse platforms.

Key Takeaways: Threads Fediverse Username Formats

  • At-handle format (@username@threads.net): The human-readable identifier you see inside Threads and share with others.
  • Webfinger format (acct:username@threads.net): The machine-readable identifier used by ActivityPub servers to look up your account.
  • Profile > Privacy > Fediverse sharing: Toggle this setting to allow your public posts to appear on Mastodon and other fediverse servers.

ADVERTISEMENT

Understanding Fediverse Username Formats on Threads

The fediverse uses the ActivityPub protocol to let different social platforms communicate. Each user on a fediverse-enabled platform has a unique identifier called an ActivityPub ID. Threads generates this ID automatically when you enable fediverse sharing. The ID is based on your Threads username and the domain threads.net.

There are two common ways to represent this ID. The at-handle format is the one people type into search bars and mention other users with. The Webfinger format is the one servers use behind the scenes to resolve the at-handle into a full profile. Both formats point to the same account, but they are not interchangeable in all contexts.

At-Handle Format

The at-handle format looks like this: @username@threads.net. For example, if your Threads username is johndoe, your at-handle is @johndoe@threads.net. This is the format you see in your Threads profile URL and the one you give to people who want to follow you from Mastodon or other fediverse platforms. It is also the format used in mentions and replies within Threads itself. When someone on Mastodon searches for your at-handle, their server uses the Webfinger protocol to find your full profile.

Webfinger Format

The Webfinger format looks like this: acct:username@threads.net. For the same user johndoe, the Webfinger identifier is acct:johndoe@threads.net. This format is not meant for human sharing. It is used by ActivityPub servers when they query the threads.net domain to retrieve your public profile data. The Webfinger protocol is defined in RFC 7033 and is the standard way fediverse servers discover user accounts. You rarely need to type this format yourself, but some advanced fediverse tools and debugging interfaces display it.

How to Find and Use Your Fediverse Username on Threads

Before you can share your fediverse username, you must enable fediverse sharing in your Threads settings. This option is only available if your Threads profile is public. Private profiles cannot share posts to the fediverse.

  1. Open Threads and go to your profile
    Tap your profile picture in the bottom-right corner of the app to open your profile page.
  2. Tap the menu icon in the top-right corner
    This icon looks like two horizontal lines. It opens the settings drawer.
  3. Select Privacy from the menu
    Scroll down the menu and tap Privacy to open the privacy settings screen.
  4. Tap Fediverse sharing
    This option is near the bottom of the Privacy page. It shows a toggle switch.
  5. Turn on the toggle for Allow sharing to the fediverse
    When you enable this, a confirmation dialog appears. Tap Turn On to confirm. Your public posts are now shared to the fediverse.
  6. Find your at-handle
    Go back to your profile. Your at-handle is displayed below your display name. It looks like @username@threads.net. Tap it to copy it to your clipboard.
  7. Share your at-handle with others
    Paste the copied at-handle into a post, a message, or a bio on another platform. People on Mastodon can search this exact string to find your Threads profile.

To see your Webfinger identifier, you can use a browser-based fediverse debugger. Open a browser and go to a Webfinger lookup tool like webfinger.net. Enter your at-handle (without the @ symbol) and the domain threads.net. The tool returns your Webfinger identifier in JSON format. The acct field contains the full acct:username@threads.net string.

ADVERTISEMENT

Common Misunderstandings About Fediverse Username Formats

People cannot find me when I give them my at-handle

This usually happens because the person receiving the at-handle is on a Mastodon server that has not yet cached your Threads profile. Mastodon servers cache remote profiles for performance. When someone first searches for your at-handle, their server performs a Webfinger lookup. If the lookup succeeds, the profile appears. If it fails, the server shows no results. The most common cause of a failed lookup is that the Threads server is temporarily unreachable or that your fediverse sharing toggle is turned off. Verify that the toggle is on and ask the person to try again after a few minutes.

My at-handle appears differently on Mastodon than on Threads

On Mastodon, your profile is displayed with the at-handle format, but the domain part may be shortened to @threads.net. This is normal. Some Mastodon clients also show the Webfinger identifier in the profile details section. The two identifiers always point to the same account. If you see a different username or domain, someone may have created a fake account. Threads does not allow username changes after enabling fediverse sharing, so your at-handle remains stable.

I cannot use my Webfinger identifier to log in to anything

The Webfinger identifier is not a login credential. It is only used for account discovery. You cannot use it to log in to Threads, Mastodon, or any other service. Always use your regular Threads login credentials (email and password or Instagram account) for authentication.

Threads At-Handle vs Webfinger: Comparison Table

Item At-Handle Webfinger
Format @username@threads.net acct:username@threads.net
Primary use Human sharing, mentions, and search Server-to-server account discovery
Where it appears Threads profile, Mastodon search results Webfinger lookup responses, debug tools
Typed by users Yes, frequently Rarely, mainly for debugging
Changeable No, tied to your Threads username No, derived from your at-handle

Now you can distinguish between the at-handle and Webfinger formats for your Threads fediverse account. Share your at-handle when you want people to find you on Mastodon. Use the Webfinger identifier only when troubleshooting account discovery issues with server administrators. For a deeper understanding of how fediverse sharing works, explore the ActivityPub documentation linked from the Threads help center.

ADVERTISEMENT