Blog · Gutenberg

Taxonomy List block for WordPress

Display categories, tags or custom taxonomy as a styled list, grid, chips or cards — with icons, counts and links.

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.

Get Blockenberg

What it actually does

Display categories, tags or custom taxonomy as a styled list, grid, chips or cards — with icons, counts and links.

Inspector panels on this block: Items, Layout, Item Colors, Count & Icon. Those titles come from index.js, not from a shared template.

Behavior controls: “Layout — Style” options: List, Grid, Chips, Pills, Cards; “Count Position” options: Badge (bubble), Inline, Bracket (23); “Open Links In” options: Same Tab, New Tab.

Taxonomy List has no render.php and no frontend.js. The saved Gutenberg HTML is what visitors see, plus Blockenberg layout/typography CSS.

Where to find it

Gutenberg inserter → Blog → search “Taxonomy List” (block name `blockenberg/taxonomy-list` in block.json). Style it in the sidebar after insert.

How to use Taxonomy List block for WordPress

Install Blockenberg. Install from WordPress.org and activate the plugin.
Insert the block. Edit a page, click +, search for “Taxonomy List”, insert it. Category: Blog.
Configure inspector controls that exist on this block. Open Items. Set “Name”, “URL”, “Count”, “Layout — Style”.
Publish. Save the page. Output is the saved block HTML; typography/colors follow Blockenberg shared panels.

Inspector controls from this block’s code

Control	What the code does
Name	Text field in the inspector.
URL	Text field in the inspector.
Count	Text field in the inspector.
Layout — Style	Select control; the chosen value is saved on the block. Options: List; Grid; Chips; Pills; Cards. block.json default: list. Saved as `layout`.
Columns	Numeric range control in the inspector. Range 2–6. block.json default: 2. Saved as `columns`.
Show Icons	On/off toggle in the inspector. On by default. Saved as `showIcon`.
Show Count	On/off toggle in the inspector. On by default. Saved as `showCount`.
Count Position	Select control; the chosen value is saved on the block. Options: Badge (bubble); Inline; Bracket (23). block.json default: badge. Saved as `countPosition`.
Show Chevron Arrow	On/off toggle in the inspector. On by default. Saved as `showChevron`.
Link Items	On/off toggle in the inspector. On by default. Saved as `linkItems`.
Open Links In	Select control; the chosen value is saved on the block. Options: Same Tab; New Tab. block.json default: _self. Saved as `linkTarget`.
Gap Between Items	Numeric range control in the inspector. Range 0–32. block.json default: 8. Saved as `gap`.
Item Padding	Numeric range control in the inspector. Range 6–40. block.json default: 14. Saved as `padding`.
Border Radius	Numeric range control in the inspector. Range 0–50. block.json default: 8. Saved as `borderRadius`.
Max Width (0 = full)	Numeric range control in the inspector. Range 0–800. block.json default: 0. Saved as `maxWidth`.
Item Colors — Background	Color control in the inspector. block.json default: #ffffff. Saved as `itemBg`.
Hover Background	Color control in the inspector. block.json default: #f1f5f9. Saved as `itemBgHover`.
Text Color	Color control in the inspector. block.json default: #1e293b. Saved as `itemColor`.
Hover Text	Color control in the inspector. block.json default: #2563eb. Saved as `itemColorHover`.
Item Colors — Border	Color control in the inspector. block.json default: #e2e8f0. Saved as `borderColor`.
Accent / Chevron	Color control in the inspector. block.json default: #2563eb. Saved as `accentColor`.
Icon Color	Color control in the inspector. block.json default: #6b7280. Saved as `iconColor`.
Count Background	Color control in the inspector. block.json default: #e2e8f0. Saved as `countBg`.
Count Text	Color control in the inspector. block.json default: #475569. Saved as `countColor`.

When this is the right block

Display categories, tags or custom taxonomy as a styled list, grid, chips or cards — with icons, counts and links — that is the job of Taxonomy List, not a generic content block.
Use it when you need the editor control labeled “Name”, which exists on this block’s inspector.
It matches pages about taxonomy, category, tag.
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 Taxonomy List block in WordPress?

Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Taxonomy List”. It sits under Blog. After insert, open Items and set “Name”, “URL”, “Count”, “Layout — Style”.

What makes Taxonomy List different from other Blockenberg blocks?

Display categories, tags or custom taxonomy as a styled list, grid, chips or cards — with icons, counts and links. Inspector labels on this block include “Name”, “URL”, “Count”, “Layout — Style”.

Is the Taxonomy List Gutenberg block free?

Yes. Taxonomy List ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.

Can I style Taxonomy 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: Items, Layout, Item Colors, Count & Icon).