1. Home
  2. Help
  3. Learning Management Systems
  4. D2L
  5. Creating Hypothesis-enabled readings in D2L
  1. Home
  2. Help
  3. Learning Management Systems
  4. Using Hypothesis in the LMS
  5. Creating Hypothesis-enabled readings in D2L

This guide assumes a D2L administrator has already installed the Hypothesis LMS app at the organization level and granted access to the tool provider for your course/department/organization. For installation instructions, please see our help article: Installing the Hypothesis LMS app for D2L.

1. Add Existing Activities

In the Content area of your course, navigate to the Module or course area where you’d like to add your Hypothesis-enabled reading. Click on the Add Existing Activities drop-down and select External Learning Tools from the menu:

On the Add Activity dialog, click the Create New LTI Link button (you may have to scroll down):

3. Add a title and the Hypothesis LTI URL

Enter a sensible title for the Hypothesis-enabled reading.
In the LTI URL field, put https://lms.hypothes.is/lti_launches
Click Create and Insert when you’re done.

4. Configure assignment as an “External Resource”

Click the down-arrow to the right of the name of new LTI Link, and select Edit Properties In-place.

Location of

Check the box to Open as External Resource.

Location of

5. Select the document to be annotated

Click on the title of the LTI Link you’ve just created:

You will have the option to enter a publicly-viewable URL or to add a PDF from Google Drive.

Hypothesis content source selector

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.

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.


PDFs must have optically recognizable text in order to be annotatable in the Hypothesis app. If you can select text in the PDF, no further action is needed. If you can’t select text in the PDF, you’ll need to follow our instructions for how to OCR-optimize a PDF.

After selecting the URL or PDF for your assignment, you may need to refresh the page, or close and re-open the assignment, before you can start annotating.

6. Preview your Hypothesis-enabled reading

You will see the web page or PDF you’ve chosen with Hypothesis enabled and scoped to your automatically-provisioned private group:

You and your students will now be able to select text and annotate.

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