Topics Map > Content Creation and Distribution

Frequently Asked Questions (FAQ) about the Hypothesis Social Annotation Tool

This article provides instructors with answers to frequently asked questions about the Hypothesis annotation tool.

Covered in this article:

What is Hypothesis?

Hypothesis is a social annotation tool that is fully integrated with Canvas. Using Hypothesis, instructors can make PDFs and websites annotatable. Students can annotate course readings collaboratively, sharing comments and replying to peer’s comments. Instructors can also create annotation assignments. Through Hypothesis-enabled assignments, students submit their annotations for feedback and grading in Canvas. This short video demonstrates how to use Hypothesis in Canvas. 
This article provides additional information on Hypothesis use at UWM.

How can I use Hypothesis in my course?

  • Have students ask each other questions, share ideas, and collaborate around their learning.
  • Invite students to annotate the syllabus.
  • Make readings annotation-enabled to create an optional space for students to connect with each other.
  • Guide students through the reading with instructor annotations.
  • Use Hypothesis for seminar-style discussion online.
  • Recommend that students annotate the lecture notes.

How can I get Hypothesis support and more information?

  • CETL is happy to help you setup and use Hypothesis in your course
  • Please review the CETL schedule for upcoming Hypothesis workshops
  • UWM's Hypothesis support engineer is available at: support@hypothesis
  • Liquid Margins is a podcast-like show on Fridays, which talks about how to use the Hypothesis tools.

Are there Hypothesis workshop and/or demonstration recordings available?

  • A recordings of the "Social Annotation using Hypothesis" workshop can be viewed to learn more about the following topics:
    • Exploring successful strategies for using Hypothesis as a social annotation tool
    • Creating a Hypothesis-enabled assignment
    • Ensuring PDF materials contain digital text (optical character recognized)
    • Orienting students to Hypothesis
    • Using groups with Hypothesis
    • Connecting a rubric to a Hypothesis-enabled assignment
    • Grading student annotations
    • Getting help with Hypothesis
  • A recording of the "Collaborative Comments: Textual & Visual Annotation in Canvas" session from CETL's Teaching and Learning Symposium can be viewed. Lisa Hager (they, them, theirs) from CGS, English & Gender, Sexuality, and Women’s Studies delivered a session that focused on the pedagogical potential of digital text annotation in the online and face-to-face classrooms via Hypothesis. In thinking about visual and textual annotation as a pedagogical practice, the session discussed annotation as key starting point for active reading, collaborative responses, and brainstorming for academic writing. The presenter shared assignments from literature and gender studies classes as examples, and discussed student performance and evaluations of this part of their respective classes. 

  • A recording of the "Using Hypothesis for Social Annotations in Online and Hybrid Courses" session from CETL's Teaching and Learning Symposium can be viewed. In this Birds-of-a-Feather session, four UWM instructors presented on how they used Hypothesis to generate engagement in their courses, including examples of successful and unsuccessful strategies. They discussed the pedagogical intent behind the Hypothesis assignments, how assignments were structured, the instructor’s role participating in Hypothesis assignments, and grading strategies. Panelists included: 
    • Hilary Snow (Honors)
    • Ryan Holifield (Geography)
    • Karolina May-Chu (FLL)
    • Aaron Schutz (Educational Policy and Community Studies)

How do I assign Hypothesis-enabled materials?

Hypothesis has been enabled for use in all UWM credit-bearing (SIS) courses. There are two ways to use Hypothesis, graded and ungraded. When creating a Hypothesis-enabled Assignment in Canvas, instructors can evaluate and grade student annotations using the SpeedGrader and grades will automatically flow into the Canvas Gradebook.

In contrast to a graded assignment, you can provide an annotatable document or website link directly in the Modules area. This type of Hypothesis-enabled material cannot be graded. Normally, this would be used for readings in which Hypothesis annotation was an optional assignment. This tutorial explains using Hypothesis within Modules in Canvas.

How do I create a Hypothesis-enabled assignments?

  • This tutorial will help an instructor create a Hypothesis-enabled Assignment in Canvas.
  • Once the Hypothesis-enabled Assignment is created, be sure to add the assignment to the appropriate Canvas module on the Home page. This tutorial describes adding an Assignment to Modules.
  • You can’t add multiple PDFs to a Hypothesis-enabled assignment. You can only have one reading per assignment.

What strategies can I use at the beginning of the semester to help orient my students to Hypothesis?

  • At the beginning of semester, have students annotate the syllabus. What do they already now? What questions do they have? What are they excited to learn? 
  • Have students annotate early readings on building community, self-care, or being an online learner.
  • Be sure to communicate the advantages of using to your students (e.g. annotation makes reading visible, and makes reading social).

How do my students learn how to use Hypothesis?

Clearly articulating your expectations for how students should use Hypothesis will go a long way in preparing students for success. Many instructors demonstrate using the tool during a face-to-face class, in a synchronous class meeting (using Collaborate Ultra), or in a screen recorded video (using Kaltura Capture) posted to Canvas. 

Hypothesis provides a guide that serves as an introduction to the Hypothesis LMS App for students. This guide can be linked on Canvas to help orient your students and and support them through out the semester.

Hypothesis also created a video tutorial showing student how to annotate Hypothesis documents in Canvas. You can embed this video in a Page in Canvas and share the tutorial with your students. This tutorial will show you how to embed a video in a Page. This tutorial show how to add a Page to Modules in Canvas.

What are common issues students may experience using Hypothesis?

  • If a student annotates and posts to themselves and not the course, the Teacher cannot see the annotations. You’ll need to let your students know this information.
  • From within, the eye icon turns on and off the highlights. It’s a good idea to tell your students to read the document without the highlights and annotations first. After the first read, students can go back and re-read adding annotations and highlights as assigned.
  • When using in a synchronous way, tells students that new annotations are shown as a red circle and you can select this to see the annotations that have occurred since you last posted.

How can I use groups with Hypothesis?

In general, group size for Hypothesis follows similar recommendations for discussion group size. In-depth, threaded conversations should have smaller groups, ideally between 5-10 students. Groups smaller than 5 may suffer from a lack of new ideas and groups larger than 10-15 may become too overwhelming to follow. In comparison, if you want students to add questions/comments without replying to peers, groups can be larger -- 15-20 students.
Hypothesis integrate with the Canvas Groups feature. Check out this article from Hypothesis.

How can images be included in Hypothesis posts?

  • Images that are included in posts must “live” on a website. The image has to be publicly available on the web to add to the annotation post. Images can’t be uploaded to Hypothesis. 
  • Once you find an image on the web, right click and select “Copy Image Address” and then paste this address into the image icon in the text editor within a post. Here’s a tutorial from Hypothesis on adding images to posts.
  • Google Arts and Culture can be used to annotate images.
  • If there’s an image included in a document, you can add annotations to text around an image, but not on the image itself.
<a href=" https:=" "="""" help="" adding-links-images-and-videos-to-your-annotations="" target="_blank" title="">

      How do I create an OCRed PDF document? 

      You need to have Adobe Acrobat Professional installed on your computer through Creative Cloud. If you don’t have this software, as an UWM employee, you can procure a free license from UITS Software Asset Management. 
      Open the PDF and determine if it need to be OCRed. To do this, attempt to select the text. If you can select the text, like the image below, the PDF is OCRed. 
      If you can’t select the text, but instead draw a box on the document, like the screenshot below, you will need to perform optical character recognition. 
      If you need to perform OCR, click the Tools tab from inside Adobe Acrobat Professional, then select the Scan & OCR button. 
      Click the Recognize Text menu and select In this File
      Then select the Recognize Text button.
      A progress bar will appear on the bottom right side of the window. Once completed, save the PDF and upload to Canvas Files using this tutorial.
      Here’s a video that produced on this process:

      Why is my OCRed PDF documents not highlightable in Hypothesis?

      In rare cases, Acrobat detects that the beginning of the document has been OCRed, but doesn’t continue recognizing the rest of the document. Fortunately, there is a less sensitive, free software tool that usually doesn’t have this problem. After using the OCR detection in OCR Space, Hypothesis recognizes all the characters in the document.

      How do I grade student annotations?

      Hypothesis has been seamlessly integrated with the SpeedGrader in Canvas, making it easier to assess student annotations. The integration singles out each student’s contributions to a conversation on a document and enables instructors to enter a grade and written feedback for an annotated reading assignment. This tutorial explains how to use the SpeedGrader to assess student annotations.

      Why is the submission date wrong in the SpeedGrader?

      When assessing student annotations in the SpeedGrader, you may notice that the submission is shown with a “Dec 31, 2000 at 6pm” date.


      This date is a deliberate attempt by Hypothesis developers to allow the tool to work within the constraints of the Canvas SpeedGrader. Because students might visit an assignment, annotate on that reading, leave Canvas, and come back to annotate again, Hypothesis-enabled assignments do not have a “Submit” button, which is required for the SpeedGrader to register an accurate date and time for the submission. As a work-around, Hypothesis uses a hard-coded submission time stamp of “Dec 31, 2000 at 6pm” because this date is far enough in the past to not be mistaken for a real submission date. With that said, each student annotation contains a date/time stamp for the annotation and any edits. As a result, you’ll find the date and time listed on the individual annotation within the Hypothesis tool to be accurate.

      How do I add a rubric to a Hypothesis-enabled assignment in Canvas?

      Start by creating an Assignment that is an Online submission type. This tutorial will explain the process. If you have not already done so, create the rubric using this tutorial. Attach the rubric to the assignment using these instructions. After the rubric is attached to the assignment, change the submission type to an "External Tool" submission type and setup your Hypothesis reading. Use this tutorial and be sure to select Hypothesis in the "Configure External Tool" step.

      How do I provide access to the rubric after the assignment is changed to a Hypothesis "External Tool" submission type?

      Create a PDF of the rubric and then add this to a Canvas Page that describes the assignment and includes the rubric. Here’s an article with some addition information on this option. In your browser, you can "Print to PDF" and then change the settings to allow the rubric to fit on a single page. Then upload the PDF and attach it to the Page as a File. Here’s a screenshot of the settings I used to create a PDF of the rubric in Canvas. This is using Chrome on a Mac, but you could likely adapt the settings to your browser and OS.
      With normal Canvas assignments, you can copy your course to future semesters using the Course Import tool. When this type of copy is performed, Canvas will make a copy of the Hypothesis-enabled assignment or module item, and it will create a copy the PDF file. 
      However, there is a known issue in which Hypothesis integration does not update the assignment or module item to refer to the new file. As a result, the new Hypothesis-enabled assignment or module item will continue to look for the old version of the file that resides in the old course. When this happen, Hypothesis shows students and instructors an "Authorize Hypothesis: Hypothesis needs your authorization to launch this assignment" error message. 
      To fix this issue, you need to re-link the Hypothesis-anabled assignment to the newly copied PDF file. Here is a great tutorial from Hypothesis which explains the process of fixing a broken Canvas File link.

      KeywordsHypothesis Frequently Asked Questions (FAQ) Supporting Students Creating assignments Groups Beginning of the semester strategies annotation ideas images in posts support OCR Optical Character Recognized Adobe Acrobat rubric grading   Doc ID108215
      OwnerAmy M.GroupCETL
      Created2021-01-08 15:26:53Updated2023-10-25 11:17:51
      SitesUW-Milwaukee Center for Excellence in Teaching and Learning
      Feedback  0   0