1. Home
  2. Help
  3. Learning Management Systems
  4. Canvas
  5. Using the Hypothesis LMS App with Assignments in Canvas
  1. Home
  2. Help
  3. Top Articles
  4. Using the Hypothesis LMS App with Assignments in Canvas
  1. Home
  2. Help
  3. Learning Management Systems
  4. Using Hypothesis in the LMS
  5. Using the Hypothesis LMS App with Assignments in Canvas

Using the Hypothesis app within Assignments allows some additional functionality over creating Module Items. Instructors can assess student work in SpeedGrader, assign the reading/annotating to a particular Canvas Group and also set due dates or dates of availability for the Assignment. 

1. Navigate to your Assignments page and click the “+ Assignment” button

Location of

2. Scroll down to the Submission Type field

Note: some users may have to click a More Options button to see this field.

From the drop-down menu, choose External Tool and click Find

Location of submission type options

Then click Hypothesis from list of tools

Select Hypothesis external tool

3. Select the content source to use for your reading

You will have the option to enter a publicly-viewable URL, select a file from your Canvas file repository, or choose a file from Google Drive.

Canvas select content sources

Expand the sections below for instructions to use each option:

Click the button that says Enter the URL of web page or PDF. On the Enter URL dialog, enter a link to a public web page or PDF. Please note that the content at the link must be publicly viewable (i.e., not behind a login or paywall).

Click Submit.

Note: This feature requires use of the Canvas Developer Key.

You must upload PDFs to your Canvas file repository before completing the steps below. The Canvas File Picker does not allow for uploading new documents.

Click the button that says Select PDF from Canvas. You will see a list of PDFs that have been uploaded to your Canvas file repository.

Click on the title of the file you wish to use and click Submit.

Canvas file picker

Click the button that says Select PDF from Google Drive. You will be asked to select a Google account and/or authorize the Hypothesis LMS App to access Google Drive.

Search or browse to select a PDF to use in your reading. You may also click the Upload tab to upload a new PDF to use.

Click on the file you want to use and then click Select.

Google Drive picker

Note: This process will change the privacy of the selected Google Drive file to “Anyone with the link can view,” creating a publicly-viewable URL for the document. Please see our page on sharing settings in Google Drive for more information.

4. Indicate if this will be a Group assignment

Note: This feature requires use of the Canvas Developer Key.

By default your Hypothesis reading will make all annotations visible to all students, or, if Sections integration is enabled, split into smaller reading groups based on Canvas Section membership.

You also have the option to allow the creation of reading groups based on an existing Canvas Group Set. To enable this, check the box to indicate This is a group assignment, then select the appropriate existing Group Set from the drop-down list.

Location of

If you do not want to designate the reading as a groups assignment, leave the Group assignment box unchecked.

Click the Continue button.

5. You will be returned to the Configure External Tool window

Notice that the URL text box is now populated. Click Select.


Tip: We recommend checking the “Load In A New Tab” option. This will allow for a better reading experience for students, especially those who magnify the contents of their screen for accessibility purposes. 

6. Optional: Edit the Assignment name, instructions, due dates, and any other settings you wish to change

7. Scroll down and click Save or Save & Publish