Hypothesis is available to “web citizens” in the form of a bookmarklet, browser extension, or by using via.hypothes.is–allowing them to annotate and discuss any page on the Web.

Publishers can bring this capability directly to their content, so that users don’t have to, in the following ways:

Embedding Hypothesis

To add Hypothesis to your web site, simply add the following line to the HTML source of your page:

<script src="https://hypothes.is/embed.js" async></script>

You can configure Hypothesis by including a config tag above the the script tag. For example, the following arrangement will ensure that our yellow highlights are hidden by default:

<script type="application/json" class="js-hypothesis-config">
{"showHighlights": false}
</script>
<script src="https://hypothes.is/embed.js" async></script>

You can find the full list of configuration options in our documentation.

Good Habits

When publishing annotation friendly documents, be sure to:

  • Include a <link rel="canonical" href="..." /> tag on pages that may be available at different URLs (and for which you want to share annotations).
  • Include Open Graph Protocol content in your metadata

More background on good practices and relating documents together can be found in our Guidance for Web Publishers.

Tools, plug-ins and integrations

The Hypothesis community has developed different tools to integrate on their websites, and explore other functionality using the Hypothesis code and API.  You can find different ways to include Hypothesis in