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

This plugin will allow you to automatically embed Hypothesis in your site.

Without this plugin, you would have to follow these steps, but with this plugin you only need to check some checkboxes, and you will be good to go.


  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.


4 junija, 2019
Although this plugin appears not to have been updated, it’s because it’s simple code still works efficiently and well. This is a great tool for group annotation and public peer review, and the technical support from is top notch! Great plugin created and maintained by great people!
13 julija, 2018
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.
3 marca, 2018
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: This would help make the tool and any existing annotations more visible.
3 septembra, 2016
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 in order to see and use the feature. Still, a fantastic plugin.
3 septembra, 2016
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 7 reviews

Contributors & Developers

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


“Hypothesis” has been translated into 2 locales. 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.



  • Add new banner and logo


  • Migrate to BSD-3-Clause license
  • Document third party integration
  • Use Hypothesis namespace in PHP code


  • Do not include wp-cli.phar on releases


  • Add support for WordPress v6
  • Update to WordPress coding standard v3


  • Fix PDF links in multisite and other customized installations (props @boonbgorges).
  • Tested up to WordPress 5.2.2.
  • Updated to current WordPress Coding Standards.
  • Automated deploys to WordPress plugin directory.


  • 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 on.


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


Relicensed under the BSD to match other Hypothesis projects.