Blog · Gutenberg
Listicle block for WordPress
Rich numbered list article format for Top 10, Best of, and ranked editorial content. Each item has number badge, title, image, description, verdict and tags.
Get Blockenberg
Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.
What it actually does
Rich numbered list article format for Top 10, Best of, and ranked editorial content. Each item has number badge, title, image, description, verdict and tags.
Inspector panels on this block: List Settings, Header, Style & Spacing. Those titles come from index.js, not from a shared template.
Behavior controls: “Layout” options: List (one per row), Grid (2 columns), Magazine (alternating); “Number Style” options: Badge (filled circle), Circle (outline), Large (background), Minimal (just number); “Image Ratio” options: 16:9, 4:3, 1:1 Square, 3:4 Portrait.
Where to find it
Gutenberg inserter → Blog → search “Listicle” (block name `blockenberg/listicle` in block.json). Style it in the sidebar after insert.
How to use Listicle block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Listicle”, insert it. Category: Blog.
- Configure inspector controls that exist on this block. Open List Settings. Set “Number Style”, “Show Numbers”, “Count Down (10, 9, 8…)”, “Show Images”.
- Check the published page. The view script reads HTML data attributes: data-opts, data-rendered. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Layout | Select control; the chosen value is saved on the block. Options: List (one per row); Grid (2 columns); Magazine (alternating). block.json default: list. Saved as `layout`. |
| Number Style | Select control; the chosen value is saved on the block. Options: Badge (filled circle); Circle (outline); Large (background); Minimal (just number). block.json default: badge. Saved as `numberStyle`. |
| Show Numbers | On/off toggle in the inspector. On by default. Saved as `showNumbers`. |
| Count Down (10, 9, 8…) | On/off toggle in the inspector. Off by default. Saved as `countDown`. |
| Show Images | On/off toggle in the inspector. On by default. Saved as `showImages`. |
| Image Ratio | Select control; the chosen value is saved on the block. Options: 16:9; 4:3; 1:1 Square; 3:4 Portrait. block.json default: 16:9. Saved as `imageRatio`. |
| Image Radius | Numeric range control in the inspector. Range 0–30. block.json default: 8. Saved as `imageRadius`. |
| Show Tags | On/off toggle in the inspector. On by default. Saved as `showTags`. |
| Show Verdict Badge | On/off toggle in the inspector. Off by default. Saved as `showVerdicts`. |
| Show Star Rating | On/off toggle in the inspector. Off by default. Saved as `showRatings`. |
| Show Section Heading | On/off toggle in the inspector. Off by default. Saved as `showHeading`. |
| Heading Text | Text field in the inspector. Saved as `heading`. |
| Card Radius | Numeric range control in the inspector. Range 0–30. block.json default: 12. Saved as `cardRadius`. |
| Gap Between Items | Numeric range control in the inspector. Range 4–80. block.json default: 24. Saved as `gap`. |
| Padding Top | Numeric range control in the inspector. Range 0–120. block.json default: 0. Saved as `paddingTop`. |
| Padding Bottom | Numeric range control in the inspector. Range 0–120. block.json default: 0. Saved as `paddingBottom`. |
| Section Background | Color control in the inspector. Saved as `bgColor`. |
| Card Background | Color control in the inspector. block.json default: #ffffff. Saved as `cardBg`. |
| Card Border | Color control in the inspector. block.json default: #e5e7eb. Saved as `cardBorder`. |
| Number Background | Color control in the inspector. block.json default: #6366f1. Saved as `numberBg`. |
| Number Text | Color control in the inspector. block.json default: #ffffff. Saved as `numberColor`. |
| Colors — Title | Color control in the inspector. block.json default: #111827. Saved as `titleColor`. |
| Subtitle | Color control in the inspector. block.json default: #6b7280. Saved as `subtitleColor`. |
| Description | Color control in the inspector. block.json default: #374151. Saved as `descColor`. |
| Tag Background | Color control in the inspector. block.json default: #ede9fe. Saved as `tagBg`. |
| Tag Text | Color control in the inspector. block.json default: #6366f1. Saved as `tagColor`. |
| Verdict Background | Color control in the inspector. block.json default: #dcfce7. Saved as `verdictBg`. |
| Verdict Text | Color control in the inspector. block.json default: #15803d. Saved as `verdictColor`. |
| Stars | Color control in the inspector. block.json default: #f59e0b. Saved as `starColor`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-opts, data-rendered.
When this is the right block
- Rich numbered list article format for Top 10, Best of, and ranked editorial content. Each item has number badge, title, image, description, verdict and tags — that is the job of Listicle, not a generic content block.
- Use it when you need the editor control labeled “Number Style”, which exists on this block’s inspector.
- It matches pages about listicle, top 10, ranked.
- Inserter grouping: posts, magazines, and editorial WordPress pages.
Notes from the implementation
viewScript: this folder’s frontend.js is enqueued on the front end for this block.
FAQ
How do I add the Listicle block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Listicle”. It sits under Blog. After insert, open List Settings and set “Number Style”, “Show Numbers”, “Count Down (10, 9, 8…)”, “Show Images”.
What makes Listicle different from other Blockenberg blocks?
Rich numbered list article format for Top 10, Best of, and ranked editorial content. Each item has number badge, title, image, description, verdict and tags. Inspector labels on this block include “Number Style”, “Show Numbers”, “Count Down (10, 9, 8…)”, “Show Images”.
Is the Listicle Gutenberg block free?
Yes. Listicle ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Listicle to match my theme?
Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: List Settings, Header, Style & Spacing).
Related blog blocks
Article Header
Rich editorial-style article/blog post header with category badge, headline, subheadline, author meta bar, and optional hero image.
Book Shelf
A visual reading list with a realistic bookshelf view, cards layout, or list — complete with ratings, reading status, and genre tags.
Fact Check
Editorial fact-check verdict box with claim, verdict rating, explanation, and sources.
Opinion Box
Editorial 'My Take' opinion callout with author attribution, badge, and signed commentary.
Quote Collection
Curated editorial multi-quote grid — inspirational quotes, expert opinions, notable sayings.
Reading List
Curated book or article reading list with cover image, title, author, genre, star rating, read-status badge (Reading / Read / Want to Read / Recommended), description, and optional link.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Listicle from the Gutenberg inserter.