As a pilot, may not work perfectly. Learning Innovation would appreciate any feedback you might have if you choose to try it. is a tool that lets you collaboratively annotate and discuss webpages and documents. It enables sentence-level note taking or critique as a layer on top of class readings, news, blogs, scientific articles, books, terms of service, ballot initiatives, legislation and more. You and your students can annotate and comment on most documents you can view on the web. For examples of what you might do with, see the Liquid Margins blog. is now integrated with Duke Sakai to allow faculty and students to easily use in Duke classes. Using, students can annotate documents and webpages that are publicly accessible on the web, uploaded to Sakai Resources with a Public URL, or uploaded to Google Drive.

This page covers:

  1. Getting started with
  2. Getting help
  3. Frequently Asked Questions

Getting started with

Check out this short video on how to use in Duke Sakai.

For written instructions, please see Help: Using the Hypothesis LMS App with Lessons in Sakai.

Getting help

First check the help documentation or the FAQ below to see if your question is addressed there.

If you’re still running into issues with using, request help from Learning Innovation and we’ll help troubleshoot your issue.

You may also contact help and the OIT help desk.

Frequently Asked Questions

Help! I’m having trouble with

We are still working to document any issues that aren’t included in help documents. Check out this page first to see if your question is answered in the official documentation: LMS FAQ.

I have in my menu of tools. However, it seems I can only add one item. How can I fix this? is best utilized within the Sakai Lessons tool. Choose Add Content > Add External Tool, as specified in the Getting Started with guide.

You can remove the tool from your overall tool menu by selecting Site Info > Manage Tools and unchecking

How do I use files in Sakai Resources with

Your file in Sakai Resources must be publicly viewable for to work properly. In the Resources folder, you can can find this setting in Actions > Edit Details.

In the file details, you’ll see a link directly to the file, which you’ll need to use when setting up your document in Lessons.

Learn more about making a file publicly viewable.

Are there pages or types of websites I can’t use in

Yes, you may encounter difficulty using certain types of webpages or PDFs. While most regular web pages and documents like PDFs work well with tool, others may not work well or won’t work at all.

Often, if you can see the page on your screen, there may be a workaround. For example, if a particular page does not load properly, you can print or save the page as a PDF document, then use the “upload to Google Drive” option.

Any page that is not publicly accessible on the open web (or that requires Duke sign-in) is not accessible by and will need to be made public. Please make sure to test your document before assigning to students.

Articles from Duke Libraries which require Shibboleth/NetID sign-in or Proxy VPN do not work with Some non-paywalled pages may not work, either, so please test your article and re-upload to Google Drive if necessary.

PDF Optimization

Pages or documents need to have selectable text to work with Please use OCR text recognition on your PDF to make it possible to select text in the document. Learn more at support: how to OCR-optimize PDFs and Duke Web Accessibility: PDF Accessibility Demystified in 8 minutes.

Duplicate files will be recognized as the same item (even if they have a different file name). You may need to add a PDF Fingerprint to the file. Learn more at Support: How to save copy of a PDF with a different fingerprint.

How do groups work with Sakai? Can I set up custom sub-groups or sections?

Sakai site sub-groups or sections are not supported at this time. By default, documents can be annotated and viewable by all Sakai site participants. However, there is a workaround which uses the fingerprinting tool mentioned above.

A private group is automatically generated for courses where the Hypothesis Sakai app is installed. Neither instructors nor students will be able to create additional private groups within the Sakai context.

Learn more about Account and Group Provisioning in the Hypothesis LMS App here.

When I create a item in Sakai Lessons, I initially see the public annotations for that item.

We’ve found that this issue is fixed by simply refreshing the page.