Bridgy Fed

From IndieWeb
(Redirected from BridgyFed)
Jump to navigation Jump to search

Bridgy Fed connects IndieWeb sites with Mastodon and the fediverse. You can think of it like a POSSE and backfeed service for those servers, except that it federates instead of syndicating. Under the covers, it translates h-entry+Webmentions to/from ActivityPub.

A developers-centric summary of Bridgy Fed:

  • Bridgy Fed converts your existing site’s h-card profile, h-entry post permalinks, and Webmentions to ActivityPub, and vice versa.

How it works

One key difference between Bridgy Fed and POSSE/PESOS is that Bridgy Fed federates instead of syndicating. Fediverse implementations like Mastodon understand that your profile and posts live on your site, not as copies under a separate Mastodon user, so they link to your site properly.


You want to federate your web site with the fediverse for the same reasons you POSSE, PESOS, or backfeed to any other silo: you want to own your data, but you also want to interact with people inside that silo.

How to

See for general information on how to setup Bridgy Fed.

How to add a follow form

Your Bridgy Fed dashboard page has a form for others put their fediverse profile URL or @-@ address to follow you.

You can extract this markup and put it on your own site too!

People that have done this:

Steps to make this work:

  1. Copy the form html from your site's profile on Bridgy Fed to somewhere on your site
  2. Change the URL for the form action to be an absolute URL:
  3. Adjust classes, labels, and placeholders as desired

Here’s a summary of the HTML form.

  • replace with your @-@, and
  • replace with your domain
<form method="post" action="">
 <label for="follow-address">🐘 Follow 
  <kbd></kbd>:<br /> 
  enter your @-@ fediverse address:</label>
 <input id="follow-address" name="address" type="text" required="required"
        placeholder="" alt="fediverse address" value="" />
 <input name="domain" type="hidden" value="" />
 <input name="protocol" type="hidden" value="web" />
 <button type="submit">Follow</button>

Sample rendering:


Entering a Mastodon @-@ address that you’re logged into (in this case and clicking "Follow" will result in a screen like this:


Clicking "FOLLOW" on that screen completes the follow action, and should show a success message like this:




IndieWeb Examples

Ryan Barrett

Started using Bridgy Fed to federate with Mastodon and Hubzilla at the beginning of September 2017.

Federating a reply

Here's an example reply to a post on Mastodon:

bridgy fed indieweb reply.jpg

And here's how it shows up inside Mastodon. Note that the permalink links back to, not inside Mastodon.

bridgy fed mastodon post.jpg


Here's another reply from inside Mastodon:

bridgy fed mastodon reply.png

And here it is backfed to the original post on my site:

bridgy fed indieweb backfeed.jpg


Tantek Çelik setup Bridgy Fed on his site on 2022-10-28.

Discoverability via search in Mastodon:

2022-10-28-mastodon-follow-tantekcom.png Screenshot of a Mastodon search results page showing "Tantek Çelik" with address and profile image in a "People" tab, and icon button to the right of the result to add/follow.

What a profile looks like in Mastodon after supporting Bridgy Fed:

2022-10-28-mastodon-tantekcom-profile.png Screenshot of a Mastodon view of a profile from Bridgy Fed, showing 0 posts, in stark contrast to how feed readers immediately show all recent posts from a feed when you subscribe to a feed.

Alex Kearney

kongaloosh setup Bridgy Fed on their site on 2022-11-04:


gRegor Morrill

gRegor Morrill set up Bridgy Fed via 2022-11-15. I've successfully received a couple follow requests and sent several myself, which now appear on the following / followers pages linked from

Screenshot of my original photo post appearing in Mastodon with links and person tags (though not to Mastodon URLs)


Screenshot of how an article post appears. Only the title and link is shown. The link under the title is a Mastodon oddity (see GitHub issue), but that URL redirects to the original post:

The link preview under that link is a direct link to the original post:


Jamie Tanna

  Jamie Tanna set up Bridgy Fed on 2022-11-05 and has both been receiving and sending follows, visible on his user page

Anthony Ciccarello

Anthony Ciccarello set up Bridgy Fed on 2022-11-10 and adjusted his user name to be Mastodon users can follow using a form from his subscribe/ page.

Add yourself!

Add yourself here… (see this for more details)


Ryan Barrett had been thinking about the idea for Bridgy Fed for years, and then...

See Also