The annotated FAQ

A few weeks ago we published a frequently-asked questions page at In the time-honored tradition of the internet FAQ, we want ours to be a living document that evolves as we add features and interact with users. That tradition is often more honored in the breach than the observance, but we have an ace … Continued

An illustrated taxonomy of annotation types

I’m often asked: “What does the software do?” The elevator pitch is easy. “Visit a web page, then select some text and annotate with comments or tags. You’ll see those annotations when you return to the page, and so will other Hypothesis users.” As a general proposition that seems to make sense to almost … Continued

Annotating to extract findings from scientific papers

David Kennedy is a neurobiologist who periodically reviews the literature in his field and extracts findings, which are structured interpretations of statements in scientific papers. He recently began using Hypothesis to mark up the raw materials for these findings, which he then manually compiles into a report that looks like this:     The report … Continued

Introducing Groups

Our mission here at Hypothesis is to enable a conversation over the world’s knowledge. So far that’s been a public conversation. But some conversations need to flourish in private spaces. You’ve always been able to create private annotations that only you can see but, until today, not annotations visible only to a group. That’s what we’re launching … Continued

Do-it-yourself anchoring and the evolution of the Hypothesis toolkit

Here’s a picture of a web page with two annotations made using Hypothesis. If you’re familiar with our tool, you’ll notice that these highlights are unusual. Normally they’re yellow, here they’re gray and green. Another difference: hovering over an annotation’s highlight displays its text in a tooltip. Opening the Hypothesis sidebar reveals the source of … Continued

Using Atom feeds to receive Hypothesis notifications in Slack

Update: We have since implemented RSS and that turns out to be a better solution than Atom for Slack integration. To use it, just change stream.atom to stream.rss in the examples here. At Hypothesis we’ve recently started using Slack for team communication. We’ve also recently spruced up our Atom feed. Let’s look at how you … Continued

Integrating Hypothesis using Ajax and CORS

We’ve recently added two ways to integrate Hypothesis with other systems: CORS (Cross-Origin Resource Sharing) and Atom. We’ll explore what you can do with CORS here, and with Atom feeds in another post. It’s long been possible to embed Hypothesis in an iframe on a web page. On this page you can see two examples. The first … Continued

Farewell to bookmarklets

This post originated as in the voice of Jon Udell, not the voice of Hypothesis. I posted it here in part to explore how Hypothesis can attach annotations to documents that are the same or similar. Dan Whaley made some annotations to the WordPress preview here that reflect the voice of Hypothesis. Now what? … Continued

Synchronizing annotations between local and remote PDFs

People are sometimes surprised to learn that can annotate PDFs. They’re even more surprised when they learn you can annotate a local copy of a PDF in a way that synchronizes with another local copy and/or with a web copy of the same PDF. Here’s a browser with a local PDF in one tab … Continued