1. Home
  2. Help
  3. Learning Management Systems
  4. Blackboard
  5. Creating Hypothesis-enabled Readings in Blackboard Ultra
  1. Home
  2. Help
  3. Learning Management Systems
  4. Using Hypothesis in the LMS
  5. Creating Hypothesis-enabled Readings in Blackboard Ultra

This article is for creating assignments in Blackboard Ultra. For the corresponding Blackboard Learn page see Creating Hypothesis-enabled Readings in Blackboard Learn.

Note: The following assignment creation workflow assumes that an administrator has previously added Hypothesis as an LTI Course Content tool as described in Installing the Hypothesis LMS app for Blackboard: Administrator Guide.

1. Add a new Course Content item

From the Course Content page, click on the plus (+) icon to show the Create Content menu. Select Content Market.

Location of

2. Find the Hypothesis tool and click the “+” button

Under Institution Tools locate Hypothesis and click the plus (+) icon in the lower right corner. Note: Do not click anywhere else on the Hypothesis panel but the small plus icon.

Location of plus icon in the Hypothesis tool pane

3. Edit the assignment name and settings

A Hypothesis content item should now be visible on the Course Content page. Click the 3 dots on the right side of the Hypothesis entry and select Edit.

Location of

Change the name of the Hypothesis assignment to something appropriate. Check the box to Create gradebook entry for this item if desired, and set the grading options.

Hypothesis assignment settings

Click Save when finished.

4. Click on the newly created content item to finish configuring your Hypothesis assignment

You will have the option to enter a publicly-viewable URL, select a file from your Blackboard course files (if enabled for your school), or choose a file from Google Drive.

Blackboard 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 the Submit button.

Note: This option is only available if Blackboard Files Integration has been enabled for your school.

Before using this option, we strongly recommend following the instructions provided here to ensure that the PDFs have been configured with the proper permissions for use with Hypothesis.

Click the button that says Select PDF from Blackboard. You will then be able to browse your Blackboard course files to select the PDF you wish to use in the Hypothesis reading.

Highlight the file you wish to use and click the Select button.

Blackboard Files 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 the Select button.

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.

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.