Toggle Block
Add a toggle in the WordPress block editor to show and hide another block.
by Happy Prime · github.com/happyprime/toggle-block · website
Install
The author publishes release zips, so WP-CLI can install straight from GitHub:
wp plugin install https://github.com/happyprime/toggle-block/releases/download/1.0.0/toggle-block.1.0.0.zipReadme
Toggle Block
Add a toggle in the block editor to show and hide another block.
Description
Toggle Block is a very rudimentary block. It renders as a <button> element on the front-end that is used to show or hide another target element (via its ID) on the page. It uses aria-controls and aria-label in an attempt to make it compatible with assistive technology.
The intended use is in a site's template, through the site editor or your theme files, rather than as a block that is frequently used in content.
Changelog
1.0.0
- Initial WP.org release.
- Add block selection interface.
- Add additional block supports: background image, background size, text align, shadow, and writing mode.
- Update to latest dependencies, build process, and code standards.
0.6.0
- Add toggle group support: when toggle blocks are inside a container with the
toggle-block-groupclass, activating one toggle automatically closes others in the group. - Add a "Default toggle" option to mark which toggle should be active by default in a group.
- Extend block supports to match paragraph and heading blocks: add font family, font style, font weight, letter spacing, text decoration, text transform, writing mode, border, and link color support.
- Only render
aria-labelwhen screen reader text is provided, allowing the button text to serve as the accessible name by default. - Use
aria-expandedinstead of botharia-pressedandaria-expandedfor toggle state. - Update to latest dependencies, build process, and code standards.
0.5.0
- Wrap button text in a
<span>element to help with styling. - Move editor styles to an editor-only stylesheet.
- Update to latest dependencies, build process, and code standards.
0.4.0
- Add an attribute to toggle a toggle block-specific class on the body element.
- Allow the toggle block to be placed inside the
core/navigationblock. - Add transform support from/to
core/navigation-linkblocks. - Update to latest dependencies, build process, and code standards.
0.3.1
- Add persisting
toggle-block-has-been-toggledclass to toggled element when first toggled.
0.3.0
- Add persisting
toggle-block-has-toggledclass to toggle button when first clicked. - Update
@wordpress/scriptsto 27.7.0. - Update project dependencies.
Read the full README on GitHub →
Releases
| Tag | Published | Asset | Downloads |
|---|---|---|---|
| 1.0.0 | May 27, 2026 | toggle-block.1.0.0.zip | 1 |
| 0.6.0 | Mar 10, 2026 | toggle-block.0.6.0.zip | 0 |
| 0.5.0 | Jun 11, 2025 | toggle-block.0.5.0.zip | 2 |
| 0.4.0 | May 1, 2025 | toggle-block.0.4.0.zip | 6 |
| 0.3.1 | Oct 10, 2024 | toggle-block.0.3.1.zip | 8 |
| 0.3.0 | May 9, 2024 | toggle-block.0.3.0.zip | 8 |
| 0.2.0 | Feb 23, 2024 | toggle-block.0.2.0.zip | 4 |
| 0.1.0 | Apr 19, 2023 | toggle-block.0.1.0.zip | 6 |
Active-site estimate ≈10 comes from the median of recent superseded releases. Method.