Content · Gutenberg
Numbered List block for WordPress
Visual numbered or icon section — each item has a styled badge, heading, description, optional image and optional link. Ideal for steps, benefits, and 'why choose us' sections.
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
Visual numbered or icon section — each item has a styled badge, heading, description, optional image and optional link. Ideal for steps, benefits, and 'why choose us' sections.
Inspector panels on this block: Layout, Badge, Image, Section Heading, Items. Those titles come from index.js, not from a shared template.
Behavior controls: “Layout” options: Vertical list, Grid (multi-column), Alternating (zigzag); “Text Alignment” options: Left, Center; “Badge Type” options: Auto number, Custom (per item), Icon emoji (per item), None; “Badge Shape” options: Circle, Square, Rounded.
Where to find it
Gutenberg inserter → Content → search “Numbered List” (block name `blockenberg/numbered-list` in block.json). Style it in the sidebar after insert.
How to use Numbered List block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Numbered List”, insert it. Category: Content.
- Configure inspector controls that exist on this block. Open Layout. Set “Columns”, “Text Alignment”, “Gap (px)”, “Badge Type”.
- 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: Vertical list; Grid (multi-column); Alternating (zigzag). block.json default: list. Saved as `layout`. |
| Columns | Numeric range control in the inspector. Range 2–4. block.json default: 1. Saved as `columns`. |
| Text Alignment | Select control; the chosen value is saved on the block. Options: Left; Center. block.json default: left. Saved as `align`. |
| Gap (px) | Numeric range control in the inspector. Range 16–120. block.json default: 40. Saved as `gap`. |
| Badge Type | Select control; the chosen value is saved on the block. Options: Auto number; Custom (per item); Icon emoji (per item); None. block.json default: number. Saved as `badgeType`. |
| Badge Shape | Select control; the chosen value is saved on the block. Options: Circle; Square; Rounded. block.json default: circle. Saved as `badgeShape`. |
| Show Connector Line | On/off toggle in the inspector. On by default. Saved as `showConnector`. |
| Connector Style | Select control; the chosen value is saved on the block. Options: Dashed; Solid; Dotted. block.json default: dashed. Saved as `connectorStyle`. |
| Badge Size (px) | Numeric range control in the inspector. Range 28–80. block.json default: 44. Saved as `badgeSize`. |
| Badge Font Size (px) | Numeric range control in the inspector. Range 12–36. block.json default: 18. Saved as `badgeFontSize`. |
| Show Images | On/off toggle in the inspector. Off by default. Saved as `showImage`. |
| Image Position | Select control; the chosen value is saved on the block. Options: Right; Left; Above. block.json default: right. Saved as `imagePosition`. |
| Image Width (px) | Numeric range control in the inspector. Range 80–500. block.json default: 180. Saved as `imageSize`. |
| Image Radius (px) | Numeric range control in the inspector. Range 0–40. block.json default: 12. Saved as `imageRadius`. |
| Show Heading | On/off toggle in the inspector. On by default. Saved as `showHeading`. |
| Show Subtext | On/off toggle in the inspector. Off by default. Saved as `showSubtext`. |
| Badge Text | Text field in the inspector. |
| Heading | Text field in the inspector. |
| Link (optional) | Text field in the inspector. |
| Padding Top (px) | Numeric range control in the inspector. Range 0–240. block.json default: 0. Saved as `paddingTop`. |
| Padding Bottom (px) | Numeric range control in the inspector. Range 0–240. block.json default: 0. Saved as `paddingBottom`. |
| Colors — Background | Color control in the inspector. Saved as `bgColor`. |
| Badge BG | Color control in the inspector. block.json default: #6366f1. Saved as `badgeBg`. |
| Badge Text | Color control in the inspector. block.json default: #ffffff. Saved as `badgeColor`. |
| Item Heading | Color control in the inspector. block.json default: #111827. Saved as `headingColor`. |
| Item Text | Color control in the inspector. block.json default: #4b5563. Saved as `textColor`. |
| Connector Line | Color control in the inspector. block.json default: #d1d5db. Saved as `connectorColor`. |
| Section Heading | Color control in the inspector. block.json default: #111827. Saved as `sectionHeadingColor`. |
| Section Subtext | Color control in the inspector. block.json default: #6b7280. Saved as `subtextColor`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-opts, data-rendered.
When this is the right block
- Visual numbered or icon section — each item has a styled badge, heading, description, optional image and optional link. Ideal for steps, benefits, and 'why choose us' sections — that is the job of Numbered List, not a generic content block.
- Use it when you need the editor control labeled “Columns”, which exists on this block’s inspector.
- It matches pages about numbered, steps, benefits.
- Inserter grouping: articles, cards, lists, and long-form layouts.
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 Numbered List block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Numbered List”. It sits under Content. After insert, open Layout and set “Columns”, “Text Alignment”, “Gap (px)”, “Badge Type”.
What makes Numbered List different from other Blockenberg blocks?
Visual numbered or icon section — each item has a styled badge, heading, description, optional image and optional link. Ideal for steps, benefits, and 'why choose us' sections. Inspector labels on this block include “Columns”, “Text Alignment”, “Gap (px)”, “Badge Type”.
Is the Numbered List Gutenberg block free?
Yes. Numbered List ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Numbered List 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: Layout, Badge, Image, Section Heading).
Related content blocks
Step Progress
Horizontal wizard progress bar showing current step out of N with labels and colors.
Styled List
Fully customizable list with icons, rich text, and flexible layout options.
Icon
Standalone styled icon with label, link, shape, animation, and rich customization.
Icon Accordion
Visually rich accordion with per-item icons, badges and custom colours — great for FAQs, feature lists and onboarding flows.
Icon Box
Single card with icon, title, text, and optional link button. Perfect for feature lists inside Row/Column.
Icon Stats
Statistics displayed with large decorative icons, bold numbers, and descriptive labels.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Numbered List from the Gutenberg inserter.