1. Home
  2. Help
  3. Tutorials and How-Tos
  4. Creating Hypothesis-enabled Readings in Moodle
  1. Home
  2. Help
  3. Learning Management Systems
  4. Moodle
  5. Creating Hypothesis-enabled Readings in Moodle

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. If you have not installed Hypothesis in Moodle yet, see:

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

You will see two options for selecting a document: Enter the URL of web page or PDF (see 2A) and Select PDF from Google Drive (See 2B). The screen will look like this:

2. Select a Text

A. Enter the URL of web page or PDF

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).

B. Select PDF from Google Drive

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.

Click the button that says Select PDF from Google Drive. You will be asked to authorize a Google account, and then you’ll be able to search for and select a file, or upload a new one. Click on the file you want to use and then click Select.

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

Related Articles

In order to support easy reuse, revision, remixing, and redistribution, the entire Hypothesis Help knowledge base by Hypothesis is dedicated to the public domain via CC CC0 1.0. While we appreciate attribution and links back to Hypothesis from anywhere these works are published, they are not required. Learn more about how we made the decision to put our guidance in the public domain and let us know how you are putting Hypothesis Help to good use.