1. Home
  2. Knowledge Base
  3. Learning Management Systems
  4. Blackboard
  5. Creating Hypothesis-Enabled Readings in Blackboard Learn Original
  1. Home
  2. Knowledge Base
  3. Learning Management Systems
  4. Using Hypothesis in the LMS
  5. Creating Hypothesis-Enabled Readings in Blackboard Learn Original

Creating Hypothesis-Enabled Readings in Blackboard Learn Original

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

The process for creating Hypothesis-enabled readings in Blackboard Learn Original differs depending on whether an admin has installed the app or an instructor is using the app without a Blackboard admin installing it for them.

If an administrator has installed the app:

1. Select “Content” from the Blackboard sidebar, click “Build Content” and select “Hypothesis” from the menu

Location of

Note: If you do not see Hypothesis listed in the menu, you will need to first make the tool visible by selecting Customization > Tool Availability from the sidebar, locating Hypothesis in the list, and checking the box to make Hypothesis Available In Content Area.

Location of

2. Configure your Hypothesis assignment

Enter an appropriate name for your assignment (e.g. “Hypothesis Reading Week 1”) and adjust any other relevant configuration settings.

If you want to be able to grade this assignment later, under Enable Evaluations select Yes and enter a number for the maximum points possible.

Location of

You can read about grading Blackboard assignments here.

Click the Submit button to save the assignment. You will now see the new Hypothesis content item listed:

Hypothesis assignment listing

3. 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 PDF from your Blackboard course files (if enabled for your school), select a PDF from Google Drive, or select a PDF from OneDrive.

Assignment content configuration window with document source options shown

Expand the sections below for instructions to use each option:

Notes:

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.

Click the button that says Enter 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).

Enter URL source content window

Click the Submit button.

Note: This option is only available if a Blackboard REST API 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

Using a PDF stored in Google Drive within the Hypothesis LMS app will change the sharing settings of the selected file to allow the PDF to be shown to anyone viewing the assignment. The exact setting on the file will be “Anyone with a link can view”. For more information please see our articles on Google Drive sharing settings and using Hypothesis with Google Drive.

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. To use an institutional Google Drive account you need to already have the ability to share documents with users outside your organization.

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.

Only files for which you have edit permission are able to be used by Hypothesis.

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

Google Drive picker

Note: This process will change the sharing permission of the selected Google Drive file to allow the PDF to be shown to anyone viewing the assignment. For more information please see our document about using Hypothesis with Google Drive.

Click the button that says Select PDF from OneDrive. You will be asked to select a Microsoft account and/or authorize the Hypothesis LMS App to access OneDrive. To use an institutional OneDrive account you need to already have the ability to share documents with users outside your organization.

Once logged on, browse to select a PDF to use in your reading. You may also select the Upload option to upload a new PDF to use.

Only files available in “My files” are able to be used by Hypothesis. You will be unable to use PDFs that belong in any Shared Libraries.

Click to select the file you want to use and then click the Open button.

OneDrive file picker

Note: This process will change the sharing permission of the selected OneDrive file to allow the PDF to be shown to anyone viewing the assignment. For more information please see our document about using Hypothesis with OneDrive.

When selecting a text from JSTOR it must be one that your school has license to access, and you must use the JSTOR stable URL. Complete instructions here.

Find and copy the Stable URL of the article you will be assigning from JSTOR.org. The stable URL is listed as part of the content metadata section of the page, usually under the title, author, and journal information.

Select the JSTOR article option in the Hypothesis picker during the assignment creation process and paste the stable URL into the text field. Click the right arrow and then accept JSTOR’s terms of use.

Click the arrow after submitting a URL from JSTOR

When selecting a text from VitalSource it must be one that your and your students have access to independent of Hypothesis. Complete instructions here.

Open your VitalSource bookshelf, and then find and copy either the text’s VBID or the text’s URL.

Location of VitalSource text details button and URL

Select the VitalSource article option in the Hypothesis picker during the assignment creation process and paste the VBID or URL into the text field. Click the right arrow and then the “Select Book” button.

Location to enter the VitalSource URL

In the next screen select the starting point of the assignment (for example, you may have a specific assignment start on the book’s 2nd chapter instead of starting at the beginning of the book for every assignment).

With the starting point selected, click the Select button.

Choosing the YouTube option enables an instructor to create an assignment where users can watch the selected YouTube video and annotate its transcript simultaneously. Here’s what a YouTube assignment in Hypothesis looks like:

Hypothesis YouTube assignment with transcript shown

Click here to view the detailed steps on how to set up a Youtube video assignment in Hypothesis.

4. Indicate if this will be a Group assignment

Note: This option is only available if a Blackboard REST API integration has been enabled for your school.

By default your Hypothesis reading will make all annotations visible to all students in the course.

You have the option to allow the creation of reading groups based on a pre-existing 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 to indicate a Group Assignment

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

Click the Continue button.

5. Preview your Hypothesis-enabled reading

The reading should now open with the Hypothesis sidebar loaded.

Hypothesis reading and sidebar

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

If an administrator has not installed the app:

Note: These steps require that you have already generated Hypothesis credentials as described in Installing the Hypothesis LMS app for Blackboard: Instructor Guide. To eliminate the requirement for entering the credentials for each new assignment, have an administrator install the app site-wide for you.

Location of

  • Name:
    • Enter an appropriate name for your assignment (e.g. “Hypothesis Reading Week 1”)
  • URL:
    • https://lms.hypothes.is/lti_launches (non-Canada only)
    • https://lms.ca.hypothes.is/lti_launches (🇨🇦 Canada only)
  • Check the box to select This link is to a Tool Provider
  • Key and Secret:
  • Custom Parameters:
    • Leave blank

Web Link configuration

3. Configure your Hypothesis assignment

Configure any relevant assignment settings.

If you want to be able to grade this assignment later, under Enable Evaluations select Yes and enter a number for the maximum points possible.

Location of

You can read about grading Blackboard assignments here.

Click the Submit button to save the assignment. You will now see the new Hypothesis content item listed:

Hypothesis assignment listing

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 PDF from your Blackboard course files (if enabled for your school), select a PDF from Google Drive, or select a PDF from OneDrive.

Assignment content configuration window with document source options shown

Expand the sections below for instructions to use each option:

Notes:

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.

Click the button that says Enter 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).

Enter URL source content window

Click the Submit button.

Note: This option is only available if a Blackboard REST API 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

Using a PDF stored in Google Drive within the Hypothesis LMS app will change the sharing settings of the selected file to allow the PDF to be shown to anyone viewing the assignment. The exact setting on the file will be “Anyone with a link can view”. For more information please see our articles on Google Drive sharing settings and using Hypothesis with Google Drive.

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. To use an institutional Google Drive account you need to already have the ability to share documents with users outside your organization.

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.

Only files for which you have edit permission are able to be used by Hypothesis.

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

Google Drive picker

Note: This process will change the sharing permission of the selected Google Drive file to allow the PDF to be shown to anyone viewing the assignment. For more information please see our document about using Hypothesis with Google Drive.

Click the button that says Select PDF from OneDrive. You will be asked to select a Microsoft account and/or authorize the Hypothesis LMS App to access OneDrive. To use an institutional OneDrive account you need to already have the ability to share documents with users outside your organization.

Once logged on, browse to select a PDF to use in your reading. You may also select the Upload option to upload a new PDF to use.

Only files available in “My files” are able to be used by Hypothesis. You will be unable to use PDFs that belong in any Shared Libraries.

Click to select the file you want to use and then click the Open button.

OneDrive file picker

Note: This process will change the sharing permission of the selected OneDrive file to allow the PDF to be shown to anyone viewing the assignment. For more information please see our document about using Hypothesis with OneDrive.

When selecting a text from JSTOR it must be one that your school has license to access, and you must use the JSTOR stable URL. Complete instructions here.

Find and copy the Stable URL of the article you will be assigning from JSTOR.org. The stable URL is listed as part of the content metadata section of the page, usually under the title, author, and journal information.

Select the JSTOR article option in the Hypothesis picker during the assignment creation process and paste the stable URL into the text field. Click the right arrow and then accept JSTOR’s terms of use.

Click the arrow after submitting a URL from JSTOR

When selecting a text from VitalSource it must be one that your and your students have access to independent of Hypothesis. Complete instructions here.

Open your VitalSource bookshelf, and then find and copy either the text’s VBID or the text’s URL.

Location of VitalSource text details button and URL

Select the VitalSource article option in the Hypothesis picker during the assignment creation process and paste the VBID or URL into the text field. Click the right arrow and then the “Select Book” button.

Location to enter the VitalSource URL

In the next screen select the starting point of the assignment (for example, you may have a specific assignment start on the book’s 2nd chapter instead of starting at the beginning of the book for every assignment).

With the starting point selected, click the Select button.

Choosing the YouTube option enables an instructor to create an assignment where users can watch the selected YouTube video and annotate its transcript simultaneously. Here’s what a YouTube assignment in Hypothesis looks like:

Hypothesis YouTube assignment with transcript shown

Click here to view the detailed steps on how to set up a Youtube video assignment in Hypothesis.

5. Indicate if this will be a Group assignment

Note: This option is only available if a Blackboard REST API integration has been enabled for your school.

By default your Hypothesis reading will make all annotations visible to all students in the course.

You have the option to allow the creation of reading groups based on a pre-existing 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 to indicate a Group Assignment

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

Click the Continue button.

6. Preview your Hypothesis-enabled reading

The reading should now open with the Hypothesis sidebar loaded.

Hypothesis reading and sidebar

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

Edit and reconfigure the Hypothesis reading assignment

At any time you can reconfigure the Hypothesis reading assignment to use a new document or group set:

  • With the reading assignment open, click Edit next to the assignment name in the Grade Bar
    Location of Edit link in the Grade Bar
  • If the assignment will not open and shows an error message, you can click the Edit assignment link at the bottom of the window

BB Files Error

Was this article helpful?

Related Articles