Hypothesis is a web annotation tool that allows users to provide commentary, references, and insight on top of news, blogs, scientific articles, books, terms of service, ballot initiatives, legislation and regulations, software code and more. You can find out more at http://hypothes.is/


  1. Upload hypothesis.php to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. You’re done! The frontend of your site should now be enabled to use Hypothesis.


Simple, but effective

While it’s relatively easy to add open-source, standards-based Hypothesis annotation to any website by adding just a line of code, this plugin makes it even easier and enables some basic configuration controls such as limiting annotation to just post or page types, excluding annotation on the home page, blog page, or specific posts/pages, highlights on by default, sidebar open by default, etc.

I agree it would be nice if the plugin supported custom content types beyond WP’s standard pages and posts.

Convenient and easy installation

Very simple to install, and I appreciate the options to customize when the sidebar is displayed! One thing I’d love to request are shortcodes to open the sidebar, akin to the “Annotations” buttons eLife has implemented (example here: https://elifesciences.org/articles/33220) This would help make the tool and any existing annotations more visible.

Great plugin

Works perfectly. No problems installing it. interface and integration are great. The only Decent annotator plugin available IMO.

One thing that would make it perfect: allowing full integration in the wordpress install with annotations stored in the database and users being able to annotate once logged in to the wordpress powered website.

This is the only real downside that each user/visitor to my website has to register and login to hypothes.is in order to see and use the feature.

Still, a fantastic plugin.

Fantastic idea,

That is a fantastic idea, I wish there were to be a wp user integration that syncs with hypotesis database.

This is a great feature for membership sites!

Read all 6 reviews

Contributors & Developers

“Hypothesis” is open source software. The following people have contributed to this plugin.


“Hypothesis” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Hypothesis” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Fix an incompatibility with PHP < 5.4 introduced in the last release.
  • Load plugin textdomain.


  • Add localization support.
  • Fix an error in options sanitization routine.


  • Refactor per-post type settings for Hypothesis display.
  • Add hypothesis_supported_posttypes to allow developers to support their custom post types.


  • Add customized embedding options
    • Show highlights by default
    • Sidebar open by default.
    • Disable click to close.


  • Add option to allow on select pages or posts
  • Remove category IDs override


Introduce settings panel and enabling/disabling functionality.
– Adds Hypothesis settings panel
– Admins can now configure which pages, posts, or categories
to load Hypothes.is on.


Bumped version to work out release process. No code changes.


Relicensed under the BSD to match other Hypothesis projects.