Using Hypothesis

How to use Hypothesis as a user and developer

What can you do with Hypothesis?

  • Annotate and discuss web pages
  • Share annotations
  • Add annotation tools to your own web pages
  • Fetch public annotations via the API

Annotate web pages

View and add annotations on any web page using the Hypothesis sidebar.

Links on the homepage.

  • Go to any web page or PDF
  • Click the bookmarklet or extension icon to activate
  • Annotate!
  • Make annotations public, private or shared with a private group
  • Add tags, images, lists, code etc. (Supports Markdown and LaTeX equations)
  • Reply to others' annotations and get notifications of replies

See what others are annotating

  • See all Public and Private annotations at
  • RSS feed also available

Share annotations

  • Each annotation has a link that you can share
  • Link to an annotated version of any web page:<URL>

Add Hypothesis to your web pages

You can add Hypothesis to your own web pages.

        window.hypothesisConfig = function () {
            return { showHighlights : true };
    <script defer src=""></script>


  • Does not work on local files (with file:///) URLs, you'll need to serve the app with a simple web server

  • If you serve the same content from multiple pages, include a link to the main URL.

    <link rel="canonical" href="">

Get data from

Hypothesis has an API. Get public annotations for any web page:


Search for annotations:


More documentation at

What else can you do with the API?

  • Create, update and delete annotations
  • Search by tag etc.
  • Get RSS feeds for all annotations on a site

Build your own version of Hypothesis

  • You can build and run your own instance. See the documentation site
  • Open source libraries for anchoring annotations