Media · Gutenberg
Image Cards block for WordPress
A responsive grid of rich cards with images, category tag, title, description and CTA. Perfect for blog previews, portfolio, services or team showcases.
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 responsive grid of rich cards with images, category tag, title, description and CTA. Perfect for blog previews, portfolio, services or team showcases.
Inspector panels on this block: Cards, Layout & Style. Those titles come from index.js, not from a shared template.
Behavior controls: “Card style” options: Shadow card, Bordered, Flat, Overlay (image bg); “Hover effect” options: Lift, Scale image, None; “CTA style” options: Link + arrow, Solid button; “Image aspect ratio” options: 16:9, 4:3, 3:2, 1:1 (square), 2:3 (portrait).
Image Cards 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 → Media → search “Image Cards” (block name `blockenberg/image-cards` in block.json). Style it in the sidebar after insert.
How to use Image Cards block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Image Cards”, insert it. Category: Media.
- Configure inspector controls that exist on this block. Open Cards. Set “Title”, “Description”, “Tag/category”, “CTA label”.
- 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 |
|---|---|
| Title | Text field in the inspector. |
| Description | Text field in the inspector. |
| Tag/category | Text field in the inspector. |
| CTA label | Text field in the inspector. |
| CTA URL | Text field in the inspector. |
| Card style | Select control; the chosen value is saved on the block. Options: Shadow card; Bordered; Flat; Overlay (image bg). block.json default: shadow. Saved as `cardStyle`. |
| Hover effect | Select control; the chosen value is saved on the block. Options: Lift; Scale image; None. block.json default: lift. Saved as `hoverEffect`. |
| CTA style | Select control; the chosen value is saved on the block. Options: Link + arrow; Solid button. block.json default: link-arrow. Saved as `ctaStyle`. |
| Image aspect ratio | Select control; the chosen value is saved on the block. Options: 16:9; 4:3; 3:2; 1:1 (square); 2:3 (portrait). block.json default: 16/9. Saved as `imageAspect`. |
| Columns | Numeric range control in the inspector. Range 1–4. block.json default: 3. Saved as `columns`. |
| Gap (px) | Numeric range control in the inspector. Range 8–80. block.json default: 28. Saved as `gap`. |
| Card radius (px) | Numeric range control in the inspector. Range 0–32. block.json default: 16. Saved as `cardRadius`. |
| Image radius (px) | Numeric range control in the inspector. Range 0–24. block.json default: 12. Saved as `imageRadius`. |
| Equal height cards | On/off toggle in the inspector. On by default. Saved as `equalHeight`. |
| Show tag/category | On/off toggle in the inspector. On by default. Saved as `showTag`. |
| Show description | On/off toggle in the inspector. On by default. Saved as `showDescription`. |
| Show CTA | On/off toggle in the inspector. On by default. Saved as `showCta`. |
| Padding top (px) | Numeric range control in the inspector. Range 0–160. block.json default: 0. Saved as `paddingTop`. |
| Padding bottom (px) | Numeric range control in the inspector. Range 0–160. block.json default: 0. Saved as `paddingBottom`. |
| Section bg | Color control in the inspector. Saved as `sectionBg`. |
| Card bg | Color control in the inspector. block.json default: #ffffff. Saved as `cardBg`. |
| Card border | Color control in the inspector. block.json default: #e2e8f0. Saved as `cardBorderColor`. |
| Colors — Title | Color control in the inspector. block.json default: #1e293b. Saved as `titleColor`. |
| Description | Color control in the inspector. block.json default: #64748b. Saved as `descColor`. |
| CTA default | Color control in the inspector. block.json default: #6c3fb5. Saved as `ctaColor`. |
| Image placeholder | Color control in the inspector. block.json default: #f3f0ff. Saved as `imagePlaceholderBg`. |
When this is the right block
- A responsive grid of rich cards with images, category tag, title, description and CTA. Perfect for blog previews, portfolio, services or team showcases — that is the job of Image Cards, not a generic content block.
- Use it when you need the editor control labeled “Title”, which exists on this block’s inspector.
- It matches pages about cards, grid, portfolio.
- Inserter grouping: video, animation, and rich media sections.
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 Image Cards block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Image Cards”. It sits under Media. After insert, open Cards and set “Title”, “Description”, “Tag/category”, “CTA label”.
What makes Image Cards different from other Blockenberg blocks?
A responsive grid of rich cards with images, category tag, title, description and CTA. Perfect for blog previews, portfolio, services or team showcases. Inspector labels on this block include “Title”, “Description”, “Tag/category”, “CTA label”.
Is the Image Cards Gutenberg block free?
Yes. Image Cards ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Image 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: Cards, Layout & Style).
Related media blocks
Image Gallery
Responsive image gallery with grid/masonry layouts, lightbox, and hover effects.
Filter Gallery
Image grid with category filter buttons. Clicking a tag shows/hides matching items with animation.
Gallery Showcase
Featured image with a clickable thumbnail strip — click any thumbnail to swap the main large view. Perfect for portfolio details, product image galleries, and case study illustrations.
Image Collage
Creative overlapping image composition with up to 5 images, custom rotations, positions, frames and a floating overlay card. Perfect for hero and about sections.
Image Slider
A responsive image carousel with captions, autoplay, arrows, dots and touch support.
Lightbox Gallery
Image grid where clicking a thumbnail opens a full-screen lightbox with prev/next navigation.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Image Cards from the Gutenberg inserter.