Inline Context
Add inline expandable notes or tooltips to provide context, definitions, and references without disrupting the reading flow.
Solid choice
Inline Context is a solid plugin choice in 2026, with a few things worth checking first. It runs on 30+ sites, is rated 5/5 and was last updated 4 weeks ago, and scores 78/100 on our health check.
- Actively developed — last update 4 weeks ago
- Tested with the latest WordPress (7.1)
- Small user base (30+ active installs)
- Very few reviews so far
How does it stack up?
Side-by-side on installs, updates, ratings & support
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Inline Context stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| annotations | #15 |
| context | #4 |
| footnote | #12 |
| inline | #7 |
| tooltip | >100 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 5 from 2 reviews
About Inline Context
From the official readme · v2.8.2Description
Inline Context is a powerful Block Editor enhancement that lets you create inline expandable notes or clean tooltip-style popovers anywhere in your content. It is ideal for content-rich websites, including editorial platforms, research sites, online magazines, documentation hubs, and educational blogs that rely on clear explanation without breaking the reader’s focus.
Instead of sending readers to glossary pages or external links, Inline Context allows you to provide definitions, references, clarifications, and annotations in place — keeping readers engaged and your content structured.
Notes can be reusable, categorized, styled, centrally managed, and automatically updated everywhere they appear.
Why this is valuable for content-heavy websites
Websites with substantial text often need:
- definitions and terminology
- source references
- background information
- contextual inline explanations
- mini footnotes without scrolling
- inline callouts, tips, or warnings
Inline Context delivers all of this with a frictionless, accessible user experience. It helps readers stay focused, reduces navigation fatigue, and improves knowledge retention — especially in long articles or research-based content.
How it works
- Highlight text in the Block Editor.
- Click Inline Context.
- Enter your note content (rich text supported).
- Optionally assign a category with custom icon & color.
- Publish — your note appears inline or as a tooltip, depending on settings.
You can also create reusable notes from a dedicated Custom Post Type. Updating a reusable note updates all instances site-wide.
Key Features
Display modes
- Inline expansion (reveals a small content panel)
- Tooltip popovers (floating contextual bubbles)
- Smart tooltip positioning to avoid off-screen display
- Direct anchor links (
#context-note-xxx) for deep linking - Auto-open on page load when accessed via link
Editor productivity
- Reusable notes with global updates
- Notes Library with usage tracking (shows where each note is used)
- Quick Search inside the editor to insert existing notes
- Rich text support via ReactQuill (bold, italic, lists, links)
- Clean, integrated Rich Text toolbar button
Categories & icons
- Create unlimited categories (Definition, Reference, External Article, Tip, Warning, etc.)
- Choose from curated Dashicons or any of 300+ icons
- Separate icons for open and closed states
Styling & customization
Full styling control from Settings → Inline Context:
- NEW in v2.6: Five pre-configured color presets for one-click professional styling
- Choose from Modern Blue, Minimalist Gray, High Contrast, Warm Earth Tones, or Dark Mode
- All presets meet WCAG 2.1 AA accessibility standards
- Link colors, hover, and focus states
- Note padding, spacing, borders, backgrounds, shadows
- Tooltip appearance
- Chevron/indicator styling
- Live interactive preview of all style changes
Accessibility & security
- ARIA support, focus lock, Escape key behavior
- Keyboard-navigable for both link and note
- DOMPurify sanitization of note content
Internationalization
Inline Context is fully translation-ready.
Examples & inspiration
The idea for this plugin originated from a project with Renée Kool — a visual artist working in public art, film, and emerging media. She wanted to create a website where a single link could reveal additional content containing multiple related links. We looked at the Dutch journalism platform De Correspondent, which use subtle inline notes to provide context without interrupting the flow of reading. You can see examples of their inline notes in this article: Hoe Nederland kampioen deeltijdwerken werd
Source code
Inline Context uses @wordpress/scripts with webpack and npm to build assets.
Full source (including uncompiled JS and CSS) is available at:
https://github.com/jooplaan/inline-context
Installation
- Upload the plugin files to
/wp-content/plugins/inline-context, or install via the Plugins screen. - Activate the plugin.
- Configure categories and styling under Settings → Inline Context.
- In the Block Editor, select text and click Inline Context.
- Add your note content and choose a category (optional).
Frequently asked questions
Does this work with the Classic Editor?
No. Inline Context is built specifically for the WordPress Block Editor (Gutenberg).
Can I change the styles?
Yes. Extensive visual customization options are available under Settings → Inline Context → Styling.
Is there a limit to the number of categories?
No. Create as many categories as your content structure requires.
Can I use any Dashicon?
Yes. You can type any Dashicon class name to use all 300+ icons.
Changelog
2.8.2 – August 27, 2026
- FIX: The “Notes” fallback section could stay visible at the bottom of posts, with clicks on a note jumping down to it instead of expanding in place. The frontend script tied its startup to DOMContentLoaded, so it never ran when a caching or optimization plugin deferred, delayed or combined the bundle until after that event had already fired
- FIX: Accessibility — the fallback section was hidden by the generic
jsclass, which Twenty Twenty, Seventeen, Sixteen and Fifteen add to the page themselves. On those themes the fallback was hidden even when this plugin’s script had not run, leaving screen reader and keyboard users pointed at a hidden anchor with no way to reach the note text. Hiding is now tied to the plugin’s own initialisation, so the fallback stays in place until the notes genuinely work - IMPROVED: Confirmed WordPress 7.1 compatibility — “Tested up to” header bumped to 7.1
- DEV: Added a
@wordpress/envconfiguration andnpm run env:*scripts for a one-command local WordPress environment - DEV: Added
tests/test-frontend.phpcovering the endnotes fallback and its accessibility guarantees - DEV:
uninstall.phpnow removes every plugin option, not just three of them
2.8.1 – May 2, 2026
- FIX: Inline context popover no longer closes when inserting an image from the WordPress Media Library
2.8.0 – May 2, 2026
- NEW: Embed images inside inline context notes via the WordPress Media Library
- NEW: Image button in the note editor toolbar (shown when image support is enabled)
- NEW: “Allow images in notes” admin setting in the General tab (default: enabled)
- NEW: Custom Quill image blot preserves alt, loading, decoding, and class attributes
- NEW:
inline_context_allowed_image_protocolsfilter for sites that need data URIs or other schemes - NEW: Three CSS variables for image sizing customization (tooltip max width/height, inline max height)
- IMPROVED: Tooltip mode caps images at ~280×200 to keep tooltips compact
- IMPROVED: Inline mode caps image height at 400px while allowing full content width
- IMPROVED: Print styles handle images with page-break avoidance and sensible sizing
- IMPROVED: Confirmed WordPress 7.0 compatibility — “Tested up to” bumped to 7.0
- IMPROVED: Always sets alt=”” on images missing alt text so screen readers don’t announce filenames
- IMPROVED: Image src restricted to http(s) and relative paths by default for security
- IMPROVED: Settings export/import now includes the image-support toggle
2.7.3 – March 21, 2026
- FIX: Category icons now align correctly with text at all icon placement settings
- FIX: Category icon double-scaling issue causing icons to render at half the intended size
2.7.2 – March 20, 2026
- FIX: Custom category icons now respond to size and placement settings
- FIX: Default chevron icon now responds to color and placement settings
- FIX: Tooltip hover mode no longer shows erratic show/hide behavior
- FIX: Admin settings JS toggles now work (display mode, link style, preset warnings)
- NEW: Icon right margin CSS variable for theme.json and admin settings
- IMPROVED: Refactored icon rendering to use consistent HTML elements for both default and category icons
- IMPROVED: Fine-tuned icon placement values for top, middle, and bottom positions
- IMPROVED: Pill style always centers icons regardless of placement setting
2.7.1 – December 30, 2025
- FIX: Keyboard shortcut Cmd+Shift+K now works correctly on first try for reusable notes
- IMPROVED: Documentation for automatic cleanup feature with WP-CLI command
Screenshots
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Inline Context alternatives
All annotations plugins →
FAQ
Inline Context: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Sep 26, 2026
Is Inline Context free?
Yes. Inline Context is free to download and use from the official WordPress.org plugin directory.
Is Inline Context safe to use in 2026?
Inline Context is a solid plugin choice in 2026, with a few things worth checking first. It runs on 30+ sites, is rated 5/5 and was last updated 4 weeks ago, and scores 78/100 on our health check.
How many websites use Inline Context?
Inline Context is active on 30+ WordPress websites and has been downloaded 1,190 times since it launched in November 2025. It was downloaded 186 times in the last 30 days.
Does Inline Context work with WordPress 7.1?
Yes. The developer has tested Inline Context up to WordPress 7.1.2, the latest release. It requires WordPress 6.0 or newer.
What PHP version does Inline Context need?
Inline Context requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was Inline Context last updated?
The latest version, 2.8.2, was released on August 29, 2026 (4 weeks ago).
Who makes Inline Context?
Inline Context is developed and maintained by Joop Laan.
What are the best alternatives to Inline Context?
The most popular alternatives to Inline Context are Simple Commenter (200+ installs), Side Matter (100+ installs) and Previu (30+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
