Moodle - Creating Hypothesis - Enabled Readings

Tags PSU


This article describes how to add a Hypothesis to a Moodle course.


This explains how to create a Hypothesis-enabled reading assignment. The app allows you to share a webpage or PDF document with the Hypothesis sidebar automatically added within the LMS.

1. Create an Activity

A. Turn editing on


B. Add an activity or resource


C. Select External tool and Add

Note that the Hypothesis app can be configured to appear in the activity menu below, in which case you can select it directly, proceed to step D (naming the assignment, and skip step E (selecting Hypothesis).

D. Enter Activity name

This should be something specific to the assignment, like "Didion reading" or "Annotate Baldwin poem".


E. Select Preconfigured tool: Hypothesis

You may not need to complete this step if either a) your campus Moodle administrator has installed the Hypothesis app for you or b) the tool has been configured to be chosen from the activity dropdown.


F. Do not add anything to the Tool URL

In fact, you shouldn't be able to.

G. (Optional) enabling grading

If you would like to grade student work in this assignment, make sure "Accept grades from the tool" is checked off under Privacy.

Then, under Grade, make sure your Type is set to "Point".

Your Maximum grade can be any number, though in the Hypothesis grading panel you'll give each student a score out of 10 points. This score is a percentage which is then applied to the Maximum grade. For example, if you set Maximum grade to 20 points, and you gave a student a 7/10 in the Hypothesis grading panel, the student's final grade would be 14 points (because 70% of 20 is 14).

H. Save and display then click Open New Window


2. Select a Text

A. Enter a Public Document URL for a document

This can be a public web page or a PDF hosted at a public website. The URL is public in that it cannot require any kind of login by a user.

To be annotatable by Hypothesis, PDFs must have optically recognizable text. If you can select text in the doc, then it does.


B. Use a PDF file from Google Drive through Google Picker

Technically, this process will generate a public URL for the document. In practice, this is a secret URL that will not be shared with anyone outside your course and cannot be easily discovered.

Authorize a Google account

Select (or upload) a file.

Again, note that you can upload a PDF to Google Drive via the Google Picker workflow.

To be annotatable by Hypothesis, PDFs must have optically recognizable text. If you can select text in the doc, then it does.

Need Additional Help?

For additional Training please visit the Teaching & Learning Technologies Training site or contact the ET&S Help Desk team on your local campus. 


Article ID: 3116
Fri 10/2/20 5:24 PM
Mon 1/25/21 1:59 PM
Applicable Institution(s):
Plymouth State University (PSU)