Giscus is a free comments system powered without your own database. Giscus uses the Github Discussions to store and load associated comments based on a chosen mapping (URL, pathname, title, etc.).

To comment, visitors must authorize the giscus app to post on their behalf using the GitHub OAuth flow. Alternatively, visitors can comment on the GitHub Discussion directly. You can moderate the comments on GitHub.

Prerequisites

Create a github repo

You need a GitHub repository first. If you gonna use GitHub Pages for hosting your website, you can choose the corresponding repository (i.e., [userID].github.io)

The repository should be public, otherwise visitors will not be able to view the discussion.

Turn on Discussion feature

In your GitHub repository Settings, make sure that General > Features > Discussions feature is enabled.

Activate Giscus API

Follow the steps in Configuration guide. Make sure the verification of your repository is successful.

Then, scroll down from the manual page and choose the Discussion Category options. You don’t need to touch other configs.

Copy _config.yml

Now, you get the giscus script. Copy the four properties marked with a red box as shown below:

Paste those values to _config.yml placed in the root directory.

# External API
giscus_repo: "[ENTER REPO HERE]"
giscus_repoId: "[ENTER REPO ID HERE]"
giscus_category: "[ENTER CATEGORY NAME HERE]"
giscus_categoryId: "[ENTER CATEGORY ID HERE]"