Marketing · Gutenberg
Social Feed block for WordPress
Display a grid of social media post cards with images, captions, engagement metrics, and platform badges.
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
Display a grid of social media post cards with images, captions, engagement metrics, and platform badges.
Inspector panels on this block: Layout, Card Style, Display, Posts. Those titles come from index.js, not from a shared template.
Behavior controls: “Columns (desktop)” options: 1, 2, 3, 4; “Columns (tablet)” options: 1, 2, 3, 4; “Columns (mobile)” options: 1, 2, 3, 4; “Card style” options: Card (shadow), Bordered, Flat.
Where to find it
Gutenberg inserter → Marketing → search “Social Feed” (block name `blockenberg/social-feed` in block.json). Style it in the sidebar after insert.
How to use Social Feed block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Social Feed”, insert it. Category: Marketing.
- Configure inspector controls that exist on this block. Open Layout. Set “Columns (desktop)”, “Columns (tablet)”, “Columns (mobile)”, “Gap (px)”.
- Check the published page. The view script reads HTML data attributes: data-cols-mobile, data-cols-tablet. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Columns (desktop) | Select control; the chosen value is saved on the block. Options: 1; 2; 3; 4. block.json default: 3. Saved as `columns`. |
| Columns (tablet) | Select control; the chosen value is saved on the block. Options: 1; 2; 3; 4. block.json default: 2. Saved as `columnsTablet`. |
| Columns (mobile) | Select control; the chosen value is saved on the block. Options: 1; 2; 3; 4. block.json default: 1. Saved as `columnsMobile`. |
| Gap (px) | Numeric range control in the inspector. Range 8–48. block.json default: 20. Saved as `gap`. |
| Card style | Select control; the chosen value is saved on the block. Options: Card (shadow); Bordered; Flat. block.json default: card. Saved as `cardStyle`. |
| Hover effect | Select control; the chosen value is saved on the block. Options: Lift; None. block.json default: lift. Saved as `hoverEffect`. |
| Padding (px) | Numeric range control in the inspector. Range 10–40. block.json default: 20. Saved as `cardPadding`. |
| Radius (px) | Numeric range control in the inspector. Range 0–32. block.json default: 16. Saved as `cardRadius`. |
| Show platform badge | On/off toggle in the inspector. On by default. Saved as `showPlatformBadge`. |
| Show avatar | On/off toggle in the inspector. On by default. Saved as `showAvatar`. |
| Show username | On/off toggle in the inspector. On by default. Saved as `showUsername`. |
| Show time ago | On/off toggle in the inspector. On by default. Saved as `showTimeAgo`. |
| Show post image | On/off toggle in the inspector. On by default. Saved as `showImage`. |
| Show metrics | On/off toggle in the inspector. On by default. Saved as `showMetrics`. |
| Image ratio | Select control; the chosen value is saved on the block. Options: 1 / 1; 4 / 3; 16 / 9; 3 / 2. block.json default: 1/1. Saved as `imageRatio`. |
| Image radius (px) | Numeric range control in the inspector. Range 0–24. block.json default: 12. Saved as `imageRadius`. |
| Content max lines | Numeric range control in the inspector. Range 2–10. block.json default: 4. Saved as `contentLines`. |
| Padding top (px) | Numeric range control in the inspector. Range 0–200. block.json default: 60. Saved as `paddingTop`. |
| Padding bottom (px) | Numeric range control in the inspector. Range 0–200. block.json default: 60. Saved as `paddingBottom`. |
| Platform | Select control; the chosen value is saved on the block. Options: Instagram; X / Twitter; LinkedIn; Facebook; TikTok. |
| Username | Text field in the inspector. |
| Posts — Content | Multiline text field in the inspector. |
| Likes | Text field in the inspector. |
| Comments | Text field in the inspector. |
| Time ago | Text field in the inspector. |
What the front-end script actually does
- The view script reads HTML data attributes: data-cols-mobile, data-cols-tablet.
- An IntersectionObserver starts work when the block enters the viewport.
When this is the right block
- Display a grid of social media post cards with images, captions, engagement metrics, and platform badges — that is the job of Social Feed, not a generic content block.
- Use it when you need the editor control labeled “Columns (desktop)”, which exists on this block’s inspector.
- It matches pages about social, feed, instagram.
- Inserter grouping: landing pages, campaign sections, and conversion 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 Social Feed block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Social Feed”. It sits under Marketing. After insert, open Layout and set “Columns (desktop)”, “Columns (tablet)”, “Columns (mobile)”, “Gap (px)”.
What makes Social Feed different from other Blockenberg blocks?
Display a grid of social media post cards with images, captions, engagement metrics, and platform badges. Inspector labels on this block include “Columns (desktop)”, “Columns (tablet)”, “Columns (mobile)”, “Gap (px)”.
Is the Social Feed Gutenberg block free?
Yes. Social Feed ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Social Feed 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, Card Style, Display, Posts).
Related marketing blocks
Social Links
Social media icon links with brand colors, custom styles, and multiple layout options.
Card CTA Grid
A grid of action cards — each with icon, title, description and link. Perfect for get-started, help, or navigation sections.
Comparison Cards
Visual side-by-side product or plan comparison cards with features, pricing, and CTA. Distinct from the tabular Comparison Table block.
Feature Grid
Responsive grid of feature cards — each with an icon, title, text, and optional link. Perfect for services, benefits, and product highlights.
Icon Feature Grid
Responsive grid of features with icons, titles and descriptions. Perfect for product pages, landing pages, and about sections.
Testimonial Wall
Masonry-style testimonial wall with platform source badges (Google, G2, Capterra, Twitter/X), per-card ratings, and featured card highlights.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Social Feed from the Gutenberg inserter.