Adding Links, Images, and Videos to Your Annotations

The Hypothesis editor allows you to include links, images, and videos in your annotations.

Also see our articles on using Markdown, and formatting annotations using LaTeX.

  1. Copy a URL that you would like to include in your annotation.

  1. In the Hypothesis client text editor, select some text in your annotation and click on the link button.


  1. The Hypothesis text editor will put square brackets around the words you have selected and will add 

( next it. Replace the with the URL you copied in Step 1,  making sure to leave the parentheses.


  1. Save your annotation to see your hyperlink in red underlined text.


Adding images

Hypothesis allows you to embed images that are already hosted on the web – if you have an image saved locally, you’ll need to upload it to a site like Imgur. Then, you can follow the steps below (Note: this works for animated GIFs as well!):

  1. Copy the URL of the image. One way to do this is to right-click (Control-Click on a PC or ⌘-Click on a Mac) an image and select “Copy Image Address” from the context menu:


  1. Return to the Hypothesis sidebar and click on the image button in the text editor. The following bit of code will appear: 


  1. Replace the with the image URL you copied in Step 1, making sure to leave the parenthesis.


  1. Add an image description in between the square brackets. This will help blind and low-vision users, and is a best practice for using images on the web. For information on how to write good image descriptions, see this

blog post from the Stanford Web Services Blog.

  1. Save your annotation to confirm that the image has been embedded properly.


Adding videos

You can link to videos hosted anywhere on the web following the steps above for adding a link, but you can also embed Youtube, Vimeo, and Flipgrid videos directly into your annotations! Copy the video URL and paste it into the annotation text editor:


Save your annotation and the video will be embedded automatically, meaning you and others can play the video directly within the annotation sidebar.