As a pilot, Hypothes.is may not work perfectly. Learning Innovation would appreciate any feedback you might have if you choose to try it.

Hypothes.is 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 Hypothes.is, see the Liquid Margins blog.

Hypothes.is is now integrated with Duke Sakai to allow faculty and students to easily use Hypothes.is in Duke classes. Using Hypothes.is, 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 Hypothes.is
  2. Getting help
  3. Frequently Asked Questions

Getting started with Hypothes.is

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

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

Getting help

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

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

You may also contact Hypothes.is help and the OIT help desk.

Frequently Asked Questions

Help! I’m having trouble with Hypothes.is.

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

I have Hypothes.is in my menu of tools. However, it seems I can only add one item. How can I fix this?

Hypothes.is is best utilized within the Sakai Lessons tool. Choose Add Content > Add External Tool, as specified in the Getting Started with Hypothes.is guide.

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

How do I use files in Sakai Resources with Hypothes.is?

Your file in Sakai Resources must be publicly viewable for Hypothes.is 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 Hypothes.is document in Lessons.

Learn more about making a file publicly viewable.

Are there pages or types of websites I can’t use in Hypothes.is?

Yes, you may encounter difficulty using certain types of webpages or PDFs. While most regular web pages and documents like PDFs work well with Hypothes.is 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 Hypothes.is 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 Hypothes.is. 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 Hypothes.is. Please use OCR text recognition on your PDF to make it possible to select text in the document. Learn more at Hypothes.is 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 Hypothes.is Support: How to save copy of a PDF with a different fingerprint.

How do Hypothes.is 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 Hypothes.is 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 Hypothes.is 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.