When a non-developer user has questions about what is the functionality of a WordPress block, the answer should be right in front of their eyes. Yet, the best way to find that answer is either by Googling or asking AI.
Why is this important?
WordPress documentation exists, but for most users it remains effectively out of reach. The problem is twofold: users don’t know where to look for help, and when they do find it, the WordPress.org documentation structure is overwhelming for non-technical audiences.
By surfacing relevant guidance directly within the block editor—contextual to the block a user is working with—this approach removes friction and delivers the right information at the moment it’s needed, without forcing users to navigate unrelated or overly technical content.
Considerations
When talking about WordPress Core blocks, an easy solution would be to have a link to that block user documentation.
In the best of worlds, I would like to see a “how-to” listed in 2-3 steps, a link to the block documentation and a recommendations widget (if they make sense) on how to improve the content visually.
.
I want WordPress documentation to feel like part of the product—not a separate destination I have to discover.- whispered by ChatGPT
A new proposal will be submitted to WordPress.org to include a link to the user documentation in the block panel, with the opportunity to add features like a “how-to” listed in 2-3 steps that could be delivered by the Notes feature. AI tools are able to provide such recommendations when they have clear definitions.
The parameters of the recommendations should be limited to the core blocks.
This post was written early in 2026 as part of the sponsorship from Kinsta ®