Skip to main content

Grow the IndieWeb with Webmentions

3 mins 📖 📖 

ssg indie-web

When I re-made my site with Eleventy, the pages didn't change much, but I had loads of fun adding new features. The most fun was webmentions and I'm here to convince you to add them!

First, let me step back and explain why webmentions exist—the IndieWeb.


Check out this official description of the IndieWeb:

The IndieWeb is a community of individual personal websites, connected by simple standards, based on the principles of owning your domain, using it as your primary identity, to publish on your own site (optionally syndicate elsewhere), and own your data—

So, a community of personal websites, connected together, used as identities, that makes ownership of data possible. 🦄 🌈 How does this all work?


Now the juicy stuff!

I think the coolest thing about the IndieWeb is that it is decentralised. Currently, there is a handful of corporations that own much of our data. With webmentions, each person owns their own data and each person can communicate with others. Webmentions are basically a way to display on your personal site ways that others have interacted with your content.

On my site I display mentions and bookmarks. It's possible for someone to link to one of my blog posts within one of their blog posts or bookmarks. If they do this, I won't know about it unless they let me know about it. Letting others know you've mentioned their posts can be done manually or can be automated.

I also display likes, retweets and replies on blog posts that I have tweeted about. If the URL to my post is in my tweet, I can gather the interactions on that tweet and display them on that post. Although most social media platforms do not support webmentions, it's possible to gather them by using a great free service called Bridgy.

Some people have had webmentions on their site for many years, so I am a bit behind. Jeremy has had webmentions since 2013. But, there are more people posting content online than ever before, and personal websites aren't shown the love they used to get.

So, there has never been a more pressing need to put content creation platforms (e.g. Medium) and social media platforms (e.g. Twitter) second, and put your very own little corner of the web first 💖

I used Max Böck's post on using webmentions in Eleventy to get started. I was able to get something on the screen quickly with Max's advice, and then I refined the incoming data a bit. Here is a summary of what I did:

  • Sign up via - if this doesn't work right away, check out ways to set up your website for indie logins (I'm able to sign in by linking to my GitHub account on my site's homepage)
  • Add two <link> tags to your HTML document's <head> element: <link rel="pingback" href="{your-domain-here}/xmlrpc"> and <link rel="webmention" href="{your-domain-here}/webmention">
  • For social media mentions, sign up to Bridgy
  • Fetch all of your site's webmention data in JSON format using one of the webmention endpoints described by IndieWebCamp co-founder Aaron Parecki and the API token provided by
  • Shape your webmention data however you like - I filter webmentions into separate re-tweet, reply, like, mention, and bookmark functions using the 'wm-property' (check out the filter functions and before you say anything, yes I know they could be DRYer)
  • Use the data to display webmentions on your blog posts

Here are some of my webmentions (from my Gatsby to Eleventy post):

Amber's webmentions on her Gatsby to Eleventy post

If all of this seems too difficult and inaccessible, please don't give up! I thought getting webmentions on my little static site would be way too difficult. But there are so many wonderful posts about setting up webmentions, and so many great people willing to help. I count myself as one of those people :) If you want to implement webmentions on your site and are stuck on any of the points I listed above, ping me on Twitter and I'll do my best to help out.

Buy me a coffee ❤️

62 Responses

Max BöckLewis NymanxmanilovechinaDionRamón HuidobroPhilip Saa 🇩🇪 #AutumnAndrea De Carolisilltron + 23 more


Max BöckAna RodriguesCharlie Don't SurfKristianKevin MarksCharlotte Rose Allen ⬛🟥⚧️🏳️‍🌈Elisabeth IrgensNoa Tamir

4 Replies

  1. Katherine M. Moss Katherine M. Moss
    I love that article! and keep it up; the minute I get my hosted version of Aperture up ... your feed's falling in there as a channel.
  2. Mark Everitt PhD Mark Everitt PhD
    I want more folk to do webmentions so I can debug all my custom crap 😅
  3. Alessio Caiazza Alessio Caiazza
    Oh yes! Webmentions are a lot of fun 🎉
  4. Thank you all so much for your kind feedback! I'm glad the post has been helpful 💜✨😭Folks have been wondering how I did the Webmentions. I have @ambrwlsn and this jekyll plugin to thank for that! Grow the IndieWeb with Webmentions

8 Mentions

  1. Ramón Huidobro Ramón Huidobro
    Excellent write up!
  2. Adactio Links Adactio Links
    Grow the IndieWeb with Webmentions | Amber Wilson…
  3. Ramón Huidobro Ramón Huidobro
    Adding webmentions to my blog posts was an absolute breeze. Thank you so much for this excellently written guide, Amber! 💜
  4. Roy Tang Roy Tang
    Shared via pocket: Grow the IndieWeb with Webmentions…
  5. Luke Bonaccorsi
  6.  + 3 more


  1. @dtinth @dtinth
  2. Jeremy Keith Jeremy Keith
    Grow the IndieWeb with Webmentions | Amber Wilson December 10th, 2020 Amber describes how she implemented webmentions on her (static) site. More important, she describes why!
  3. Mark Stanley Everitt Mark Stanley Everitt
    I really like webmentions, so it makes me happy when folk blog about them!