⚠️The 0.13 release refactored our HTML, so double-check your custom CSS rules!⚠️

Commenting and annotating

Commenting and annotating#


This is an experimental feature that may change quickly! If you’re interested in trying this out, we recommend using the master branch version of Jupyter Book.

You can add functionality for web commenting and annotating through a number of web services and tools. These allow readers of your book to share conversations, ideas and questions in a centralized location. It is useful for classes, communities of practice, asking for user feedback, etc.

Currently, these commenting engines are supported:

  • Hypothesis provides a web overlay that allows you to annotate and comment collaboratively.

  • utterances is a web commenting system that uses GitHub Issues to store and manage comments.

  • dokie.li is an open source commenting and annotation overlay for Linked Research built on web standards.


Jupyter Book uses the sphinx-comments Sphinx extension for this functionality.

Documentation for supported services

For examples of each service, as well as instructions on how to activate it, click on the links for each service in the left navigation bar or below.