Content · Gutenberg
Filterable Cards block for WordPress
A grid of content cards filterable by category, with optional images, labels, descriptions 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.
What it actually does
A grid of content cards filterable by category, with optional images, labels, descriptions and links.
Inspector panels on this block: Layout, Visibility. Those titles come from index.js, not from a shared template.
Behavior controls: “Layout” options: Grid, List, Masonry; “Filter Style” options: Buttons, Tabs, Dropdown; “Image Ratio” options: 16:9, 4:3, 3:2, 1:1 Square.
Where to find it
Gutenberg inserter → Content → search “Filterable Cards” (block name `blockenberg/filterable-cards` in block.json). Style it in the sidebar after insert.
How to use Filterable Cards block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Filterable Cards”, insert it. Category: Content.
- Configure inspector controls that exist on this block. Open Layout. Set “Columns”, “Filter Style”, “\"All\" Label”, “Image Ratio”.
- Check the published page. The view script reads HTML data attributes: data-cat, 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 |
|---|---|
| Columns | Numeric range control in the inspector. Range 1–5. block.json default: 3. Saved as `columns`. |
| Layout | Select control; the chosen value is saved on the block. Options: Grid; List; Masonry. block.json default: grid. Saved as `layout`. |
| Filter Style | Select control; the chosen value is saved on the block. Options: Buttons; Tabs; Dropdown. block.json default: buttons. Saved as `filterStyle`. |
| \"All\" Label | Text field in the inspector. block.json default: All. Saved as `allLabel`. |
| Image Ratio | Select control; the chosen value is saved on the block. Options: 16:9; 4:3; 3:2; 1:1 Square. block.json default: 3:2. Saved as `imageRatio`. |
| Card Radius (px) | Numeric range control in the inspector. Range 0–40. block.json default: 10. Saved as `cardRadius`. |
| Gap (px) | Numeric range control in the inspector. Range 8–80. block.json default: 24. Saved as `gap`. |
| Padding Top (px) | Numeric range control in the inspector. Range 0–200. block.json default: 0. Saved as `paddingTop`. |
| Padding Bottom (px) | Numeric range control in the inspector. Range 0–200. block.json default: 0. Saved as `paddingBottom`. |
| Show Images | On/off toggle in the inspector. On by default. Saved as `showImages`. |
| Show Descriptions | On/off toggle in the inspector. On by default. Saved as `showDescriptions`. |
| Show Labels | On/off toggle in the inspector. On by default. Saved as `showLabels`. |
| Show Links | On/off toggle in the inspector. On by default. Saved as `showLinks`. |
| Animate on Filter | On/off toggle in the inspector. On by default. Saved as `animateFilter`. |
| 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`. |
| Colors — Title | Color control in the inspector. block.json default: #111827. Saved as `titleColor`. |
| Description | Color control in the inspector. block.json default: #6b7280. Saved as `descColor`. |
| Label Background | Color control in the inspector. block.json default: #ede9fe. Saved as `labelBg`. |
| Label Text | Color control in the inspector. block.json default: #6366f1. Saved as `labelColor`. |
| Link | Color control in the inspector. block.json default: #6366f1. Saved as `linkColor`. |
| Filter Button BG | Color control in the inspector. block.json default: #f3f4f6. Saved as `filterBtnBg`. |
| Filter Button Text | Color control in the inspector. block.json default: #374151. Saved as `filterBtnColor`. |
| Active Filter BG | Color control in the inspector. block.json default: #6366f1. Saved as `filterBtnActiveBg`. |
| Active Filter Text | Color control in the inspector. block.json default: #ffffff. Saved as `filterBtnActiveColor`. |
| Accent | Color control in the inspector. block.json default: #6366f1. Saved as `accentColor`. |
| Category | Text field in the inspector. |
| Label | Text field in the inspector. |
| Link URL | Text field in the inspector. |
| Link Label | Text field in the inspector. |
| Featured | On/off toggle in the inspector. |
What the front-end script actually does
- The view script reads HTML data attributes: data-cat, data-opts, data-rendered.
When this is the right block
- A grid of content cards filterable by category, with optional images, labels, descriptions and links — that is the job of Filterable Cards, 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 filter, cards, grid.
- 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 Filterable Cards block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Filterable Cards”. It sits under Content. After insert, open Layout and set “Columns”, “Filter Style”, “\"All\" Label”, “Image Ratio”.
What makes Filterable Cards different from other Blockenberg blocks?
A grid of content cards filterable by category, with optional images, labels, descriptions and links. Inspector labels on this block include “Columns”, “Filter Style”, “\"All\" Label”, “Image Ratio”.
Is the Filterable Cards Gutenberg block free?
Yes. Filterable Cards ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Filterable Cards 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, Visibility).
Related content blocks
Info Cards
Flexible feature/info card grid with emoji or image icons, title, description, optional CTA and accent colors. Multiple card styles.
Accordion
Collapsible accordion panels for FAQ, features, and more.
Icon Accordion
Visually rich accordion with per-item icons, badges and custom colours — great for FAQs, feature lists and onboarding flows.
Link Card Grid
Visual navigation card grid for resource hubs and docs pages. Each card has icon, title, description, and URL.
Skills
Skills and expertise block with category groups, proficiency levels, and multiple display styles: bars, dots, tags, or circles.
Accordion Table
A data table where each row expands on click to reveal rich detail content — specs, bullet points, sub-data, or notes. Perfect for pricing tiers, product specs, API docs, and comparison matrices.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Filterable Cards from the Gutenberg inserter.