External accounts

Sifa ID's strength is your activity on the Atmosphere: what you post on Bluesky, what you publish on Leaflet, the repos you maintain on Tangled. Most professionals also publish elsewhere though. A personal blog, a GitHub account, an ORCID profile for academic work, a Mastodon presence.

External accounts let you add those to your Sifa profile. Sifa stores the link, sometimes discovers an RSS feed automatically, and renders the externally published work alongside your Atmosphere activity.

What you can link

Sifa supports these platforms today:

"Link only" means Sifa shows the URL on your profile but doesn't poll it for activity.

How to add one

In Sifa, open your profile and go to External accounts. Add an account with:

• Platform: pick from the list above.
• URL: the canonical address of the account or feed.
• Label (optional): a custom display name. Sifa uses the platform's default if you leave it blank.
• Feed URL (optional): if Sifa can't auto-discover the RSS or Atom feed, paste it here. Most of the time you can leave it blank.

Save. Sifa writes an id.sifa.profile.externalAccount record to your provider. The record is owned by you, lives on your provider, and is readable by any other app that reads id.sifa.* lexicons.

How feed discovery works

When you add a website, substack, fediverse, or rss account without specifying feedUrl, Sifa fetches the URL and looks for a feed. The discovery follows the standard auto-discovery rules:

1. <link rel="alternate" type="application/atom+xml"> or application/rss+xml in the page head.
2. Well-known feed paths (/feed, /feed.xml, /atom.xml, /rss.xml).
3. Platform-specific rules. Substack always lives at <subdomain>.substack.com/feed, Mastodon at <server>/users/<handle>.atom.

Once Sifa finds a feed, it polls daily and surfaces new items in your Activity feed. The feed URL is stored alongside the account so subsequent polls go directly to it without re-discovery.

ORCID: academic publications

Add an ORCID account and Sifa pulls your publications from the ORCID API on a daily sync. Each publication becomes an id.sifa.profile.publication record on your provider, so your publications are portable Atmosphere records, not a list locked inside ORCID.

Sifa accepts both the full URL (https://orcid.org/0000-0002-1825-0097) and the bare ID (0000-0002-1825-0097). The input is normalised before validation.

Getting your publications onto Sifa

1. If you don't have an ORCID yet, create one at orcid.org.
2. Add your publications to ORCID and set them to Everyone visibility. Works marked "Trusted parties only" or "Only me" aren't served by the public API, so Sifa can't read them.
3. Link your ORCID to Sifa. Either verify it through Keytrace, which makes it appear automatically, or add the ORCID URL by hand under External accounts.
4. Your publications show up in the Publications section of your profile, usually within a day.

Verifying your ORCID

Verification confirms you own the ORCID you linked. It puts a checkmark on the link and on each publication drawn from it. You only need one of the two methods.

Via Keytrace. If you verify your ORCID through Keytrace, Sifa detects it on its own. The checkmark and your publications appear without any further steps.

Via an ORCID researcher URL.

1. On your ORCID profile, find Websites & social links.
2. Add your Sifa profile URL (for example https://sifa.id/p/<handle>) with visibility set to Everyone.
3. Back on Sifa, press Check now next to your ORCID link.

Hiding individual publications

Every ORCID publication is shown by default. To hide one, use the eye icon next to it in your edit view. Hidden publications stay visible only to you.

Refreshing

Sifa syncs with ORCID once a day, so new works appear within 24 hours. To pull them sooner, press Refresh from ORCID in your Publications section. This needs a verified ORCID, through either method above.

Editing publications

ORCID is the source of truth for these records, so you can't edit them on Sifa. Change a title or add a DOI on orcid.org and Sifa picks it up on the next sync. If you'd rather manage a publication directly, add it by hand in the Publications section instead.

Disconnecting

Removing the ORCID link under External accounts removes every ORCID-sourced publication from your profile. Anything you added by hand stays. Re-link the same ORCID later and your hide preferences come back.

Publications not showing up?

The usual cause is visibility on ORCID's side. Open orcid.org and confirm the works are set to Everyone. Anything restricted to "Trusted parties only" or "Only me" stays off Sifa, because the public API never returns it.

GitHub: initial repo scan

Add a GitHub account and Sifa runs an initial scan of your public repositories and contributions. The scan is one-shot. Subsequent updates flow through the GitHub firehose / public events stream where available, or through periodic re-scans.

Verification

For some platforms (the ones the protocol can verify, like GitHub and ORCID) Sifa tries to confirm that the account you added is actually yours by checking for a back-link or a specific identifier. Verified accounts show a small checkmark on your profile. Un-verified accounts work the same way for content. The verification badge is informational.

Removing or editing an external account

In Sifa's profile editor, you can edit the URL, change the label, or delete the account. Deleting it removes the id.sifa.profile.externalAccount record from your provider and removes the surfaced items from your activity feed.

Records on the external service itself (your blog posts, your GitHub repos) are untouched. Sifa only manages the link record on your provider.

Want to go deeper

• Activity feed: where external-feed items show up alongside your Atmosphere activity.
• Atom feeds: Sifa publishes its own Atom feed of your activity, so other readers can subscribe the same way.
• Your data on a provider: what an external-account record looks like on your provider.