Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

A Webfinger plugin for Jekyll.

An easy Jekyll plugin for adding Webfinger support to your domain.

Note: This won't work with Github Pages, which doesn't allow plugins, unless you're building your site yourself and then committing the rendered pages directly.

What is Webfinger?

It's a way to attach information to your email address.

Take an email address, and ask its domain about it using HTTPS. For example, information about is available in JSON at:

See, Paul E. Jones' description, or Webfinger's official standard at RFC 7033 for more information.

Using jekyll-webfinger

Create a _plugins folder in your project if it doesn't exist, and place webfinger_generator.rb into it.

Then, create a _webfinger.yml in the root of your project, that looks something like this:
  name: Eric Mill

When your Jekyll site is built, it will create a URL at /.well-known/webfinger that returns:

  "subject": "",
  "properties": {
    "": "Eric Mill"
  "links": [
      "rel": "",
      "href": ""

The response will actually be compact (not indented, like the above example).


  • Webfinger requires HTTPS. If you set this up on a non-secure website (http://), be prepared for most Webfinger clients to not find your data.
  • Since this is static file hosting, the query string is being ignored. So all Webfinger requests will return the same data. This in violation of the spec, but I'm not aware of how else to implement Webfinger using static files.
  • It's on you to configure your web server to set the Content-Type to application/jrd+json for /.well-known/webfinger. If you don't, it will probably be set to application/octet-stream, which is in violation of the spec (though most clients will probably still parse it fine).
  • As I said at the top, this won't work on Github Pages unless you pre-build the site yourself. Github blocks all plugins during its build process, so you can only use jekyll-webfinger if you build the site yourself.

MIT License

This project is published under the MIT License.


Webfinger endpoint generator for Jekyll.







No releases published


No packages published