Hypothesis for Webbook Annotation and Comments

What is Hypothesis?

Hypothesis is a simple web annotation tool that allows readers to highlight and annotate webpages, enabling deeper engagement with content. While the tool is available as a browser extension that can be used on any webpage, Pressbooks allows you to build its capabilities into the pages of your webbook itself, meaning readers can read and create annotations without installing the extension (so long as they have a Hypothesis account) and public comments will be visible to anyone who comes to your book.

Once Hypothesis is enabled on your webbook (see below), any reader coming to the book will see the Hypothesis toolbar on the right, either open or minimized depending on your settings.

Image of the public view of this chapter with Hypothesis turned on

With this toolbar open, the reader will see any public annotations and can create or log into their account. Once logged in, they can select any section of text and a small icon will pop up that lets them either highlight the passage (which will remain private) or add an annotation. Annotations can be edited, deleted, replied to or shared using the icons at the bottom of the annotation section.

These annotations can also be public, private to a reader or in a private group, and the user can toggle between these options at the very top of the toolbar (the default is “Public”). You can read more about creating groups and annotating in groups on the Hypothesis website.

NOTE: If you have your book set to Private, you don’t need to create a group to keep your annotations and replies hidden from public view. The Pressbooks privacy setting means that no one can access the book, and as such they can’t see any of the Hypothesis activity on it by default.

Enabling Hypothesis in Pressbooks

By default, Hypothesis will not appear on any pages of your webbook. To enable it, follow these steps:

  1. Go to “Settings” –> “Hypothesis”
  2. Select your default behaviors for:
    1. Displaying highlights
    2. Displaying the sidebar (you can make it open by default if you wish)
    3. Enabling annotations on PDFs stored in your media library (NOTE: we discourage the use of your media library for this kind of storage)
  3. Select the parts of your book on which to allow Hypothesis annotations.
  4. Save your changes.
This is the Hypothesis settings page found under the settings area of the left toolbar.

Including & Excluding Specific Chapters or Sections

Your Hypothesis settings also offer granular control over which chapters or sections have Hypothesis enabled. To employ this option, you will need the post ID for the chapter(s) or section(s) you wish to specify. To find this, when you are in the chapter editor, look in the address bar for post=[a number].


This is the URL bar from a chapter with the post number listed

Once you have this number, you can enter it in the Hypothesis content settings in the appropriate field to allow or disallow Hypothesis on that specific page, overriding the global settings.

NOTE: If you’re entering more than one post ID, separate them with a comma only (no spaces!).


Hypothesis settings with a number typed in the section for chapter numbers


  • Collaborative editing – users can set up a private group, leave comments and editing suggestions, and discuss changes right in the document.
  • Reader feedback – if you’re sharing your book with early readers, they can offer feedback and comments, or you can leave the option open to anyone who is engaging with your books!
  • Student engagement – students can be encouraged to engage with academic texts or books being discussed in class by leaving their thoughts and talking about the text among the class, offering those less likely to speak up in class the opportunity to share their thoughts.


Icon for the Creative Commons Attribution 4.0 International License

University of Arkansas OER Style Guide Copyright © 2023 by Lora Lennertz is licensed under a Creative Commons Attribution 4.0 International License, except where otherwise noted.

Share This Book


Comments are closed.