Zach’s ugly mug (his face) Zach Leat­herman

Import your Disqus Comments to Eleventy

April 19, 2018

I’m slowly migrating off of Disqus. I want to keep my existing comment content though.

Migration is an easy sell:

  • A few KB of static HTML is faster than the Disqus JavaScript. I lazy-load Disqus but it’s 430KB ⚠️.
  • No third party JavaScript—no prying eyes!
  • Comments available without JavaScript.
  • Full control over markup and style of comments (samples provided below). Finally, I can use my web fonts 😎.
  • No annoying loading delay when someone direct-links to a comment on your page.

I wrote up the steps I took to import the Disqus export XML in my eleventy blog. This method:

  • Properly maintains comment threading as shown in the Disqus interface.
  • Uses gravatar for avatar images.
  • Works with any existing links to Disqus comments in the wild (and no annoying delay waiting for Disqus to load and jump to the comment).

As an intermediate step, I still allow users to load the Disqus interface to participate in the discussion but these comments will not be available statically until I do another export/import—this is super easy after you do it once.

My goal is to add webmentions (thanks Nicolas for the tip!), but full credit to Staticman and utterances which look great too.


Find out more about Eleventy:

Zach Leatherman is a builder for the web at Font Awesome and the creator of Build Awesome (née Eleventy/11ty), an award-winning open source website generator. He measures website performance with speedlify and at one point became too fixated on web fonts. He has given 86 talks in nine different countries at events like Beyond Tellerrand, State of the Browser, Smashing Conference, Jamstack Conf, CSSConf, and The White House. Learn more about Zach »