About this plugin
M7tawa Content Highlights is an editorial reader-highlights tool. The editor creates a separate ordered list of key points for readers instead of generating a navigation list from the article structure.
Each highlight has its own editable text. It can be written from scratch, copied from an H2 or H3 heading and rewritten, optionally linked to a selected section, or displayed as plain text.
The highlights list is independent from the article headings: it does not have to contain the same number of items, use the same wording, or follow the same order as the H2/H3 structure. The editor decides what deserves attention and how it should be presented.
This makes the plugin useful as a focused reader shortcut for long articles, tutorials, reviews, guides, recipes, and other content where selected editorial points are more useful than automatically exposing the full heading structure.
Editorial control over reader highlights
You decide which points deserve attention. Highlights are separate editorial items and are not automatically generated from every heading in the post.
Optional links to selected sections
Each highlight can optionally link to a selected H2 or H3 heading in the same post or page. A point can also remain plain text when navigation is not needed.
Copy a heading, then rewrite it
Select a heading and copy its text into the highlight field with one click. The copied text remains fully editable, so you can shorten or rewrite it for readers.
Stable heading detection
The plugin scans headings authored directly in the post content before other shortcodes expand. This helps prevent recipe plugins and other tools that generate additional front-end headings from changing the editor’s heading map.
Flexible placement
Display the highlights box automatically before or after the content, or place it exactly where you want with the [smart_highlights] shortcode.
Per-content box titles
Set a custom highlights-box title for an individual post or page while keeping the global title as the fallback.
Features include:
- Curated key points selected by the editor instead of an automatically generated full table of contents.
- Optional links from individual highlights to selected H2 or H3 sections.
- Plain-text highlights when no section link is needed.
- One-click copying of a selected heading into an editable highlight field.
- Per-point delete controls in the post/page editor.
- Drag-and-drop reordering of populated highlights, with keyboard arrow-key reordering from the drag handle.
- Optional custom box title for individual posts and pages.
- Automatic placement before or after content.
- Manual placement with [smart_highlights].
- Multiple manual placements with [smart_highlights] while preventing an extra automatic box.
- Optional smooth scrolling with a configurable sticky-header offset.
- Heading detection based on authored post content before other shortcodes expand.
- Support for the Classic Editor and the block editor.
- RTL and LTR friendly.
- Translation-ready with English as the source language.
- No AI service, external API, telemetry, or third-party content processing.
- Reads highlight data created by Simple Content Highlights 3.1.1 and migrates each post to the new meta key when that post is next saved.
Shortcode
Use [smart_highlights] inside a post or page to display the box at that exact position.