WordPress / WordPress/Documentation-Issue-Tracker
[HelpHub] Overhaul Blocks List Page
Open
@estelaris is already working on this.
Since Dec 11, 2025.
[Blocks] Blocks list page
[Status] Done
Customization
user documentation (HelpHub)
- Dominant language
- Shell
- Stars
- 109
- Forks
- 73
- PR merge metrics
- No merged PRs in 30d
Description
Issue Description
Blocks LIst page is missing recent changes to core blocks.
URL of the Page with the Issue
https://wordpress.org/documentation/article/blocks-list/
Section of Page with the issue
Blocks List and Deprecated Blocks
Why is this a problem?
This page is a great reference for new WordPress editors but is missing some info.
Suggested Fix
Add new blocks
Text Blocks:
- Math
- Stretchy Paragraph (variation mentioned in paragraph)*
- Stretchy Heading (variation mentioned in heading)*
Design Blocks:
Widget Blocks
- Terms List
- Categories List
- (Move Categories under Theme)
Theme Blocks
- Categories (Move from Widget Blocks)
- Query Title
- Term Count
- Term Name
- Terms Query
- Post Type Label
*Stretchy Paragraph and Stretchy Heading are both listed in the inserter, but maybe don't need to have links here. Other block variations such as Grid group and YouTube embeds are listed though.
Block Deprecation
- Posts List block
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.