Jekyll Integration

Jekyll is a legend of an SSG, laying the foundation of the Jamstack ecosystem even before "Jamstack" became a term. Its developer friendliness and low barrier to entry still make it a strong contender in the more "modern" era, making it an obvious one to decide to support for JamComments.

These instructions assume you've already created a JamComments account as well as a site within that account. If you haven't, learn more about that process on the Getting Started page.

Installation & Configuration

In your Jekyll site, install the plugin by running bundle add jekyll_jam_comments or by adding the following to your Gemfile:

gem "jekyll_jam_comments"

After doing so, set up the following environment variables for your site:

JAM_COMMENTS_DOMAINThe domain for your site as configured in your account. Don't include the protocol ("https").
JAM_COMMENTS_API_KEYThe API generated in your account settings.
JAM_COMMENTS_ENVIRONMENTSetting this to development will cause "dummy" comments to be locally rendered, which is helpful for styling. By default, this will fall back to the value of JEKYLL_ENV.

If you'd like to set these values within your config.yml file, you may do so:

  # config.yml
    environment: 'production' or 'development' # optional


Place the {% jam_comments %} Liquid tag on the page you'd like comments to appear. Under the hood, the plugin uses the page.url context variable to determine the page path.

<div class="post">
  <!-- content... -->

{% jam_comments %}


The source for this plugin is open to contributions. If you have a bug fix or idea for improvement, leave a pull request or issue in the GitHub repository.