WordPress Plugin for Query Loop Block
Add Masonry Layouts
To Your WordPress Query Loop Blocks
Create Pinterest-style masonry grids with the WordPress Query Loop block you already use. Control columns per breakpoint. Set custom aspect ratios. Mobile, tablet, desktop—all covered.
Pay once – yours forever. Free updates. No subscription.
Create endless custom layouts
“I Want Masonry Layouts in My Query Loop”
You’re using WordPress Query Loop for your blog posts, portfolio, or product listings. It works great, but you want that flowing Pinterest-style masonry layout. Different image heights. Natural flow. Responsive columns. You don’t want a page builder. You don’t want custom code. You just want Query Loop to do masonry. This plugin does exactly that.
Features
Everything You Need for Query Loop Masonry
Responsive breakpoints. Custom aspect ratios. Column controls. All in your Query Loop block.
Adds Masonry to Query Loop Block
Install this WordPress plugin. Open your Query Loop block. Check “Enable Masonry” in the sidebar. That’s it. Your Query Loop now flows like Pinterest. Same block, new superpower. Works with every Query Loop you have—posts, products, custom post types.
Control Columns Per Breakpoint
Set different column counts for mobile, tablet, and desktop. 2 columns on mobile, 3 on tablet, 6 on desktop—you decide. Your Query Loop masonry adapts perfectly to every screen size. All controlled from the block sidebar you already know.
Custom Aspect Ratios Per Position
Make every 1st image square. Every 2nd portrait. Every 3rd landscape. Or target specific positions—1st image hero size, 2nd and 3rd thumbnails. Mix and match aspect ratios to create the exact Pinterest-style layout you want. All visual controls in Query Loop sidebar.
Control your Grid Spacing
Control the spacing between your masonry posts using WordPress native block spacing controls. This plugin uses WordPress Query Loop’s native grid block spacing. This plugin is compatible with fluid grid spacing (via css clamp() or theme.json).
Works with AJAX or WP Interactivity
The plugin watches the masonry container for changes. When .wp-block-post elements are added or removed, masonry automatically re-calculates the layout.
Plug-in, Plug-out
Uses WordPress hooks to extend Query Loop. No proprietary blocks. Uninstall it? Your Query Loops return to normal—no broken layouts. For developers: filter options, customize selectors, full API access. This is how WordPress plugins should enhance core blocks.
Block Editor Settings
Native WordPress controls you’re used to
Enable masonry, set aspect ratio and column-span rules, set breakpoints—see what you can create
Click to enlarge
Click to enlarge
Click to enlarge
Click to enlarge
Apply unlimited combinations of the following rules
Mix and match aspect ratios with “Every Nth” or “Only Nth” patterns for complete creative control
Every
/
Only
}
1st
2nd
3rd
4th
5th
6th
…element in Query Loop
}
Square (1:1)
Portrait (3:4)
Portrait (2:3)
Landscape (4:3)
Landscape (3:2)
Landscape (16:9)
Ultra Wide (21:9)
…Aspect Ratio for Featured Image or Cover Block
Column Span 1 – 16
…or Column Span applied to element in Query Loop
Use Cases
Custom Layouts For Any Query Loop Use Case
Blog posts, portfolio items, custom post types—add masonry to any Query Loop
📝
Blog Post Grids
Turn your Query Loop blog archive into a Pinterest-style grid. Featured images flow naturally.
🎨
Portfolio Query Loops
Query Loop + custom post type = boring grid. Query Loop + this plugin = stunning portfolio masonry.
📰
News & Magazine Sites
Query Loop for latest posts + masonry + aspect ratio control = hero stories stand out, naturally.
For WordPress Developers Building Client Sites
Your client wants masonry. You’re already using Query Loop. This WordPress plugin connects them. Filter aspect ratio labels to match the client’s brand. Limit options to prevent confusion. Extend Query Loop without custom code.
✓
Filter Aspect Ratio Options
Replace generic labels with client-friendly terminology. “Product Image” instead of “1:1”.
✓
Custom number of selector position slots
Control the maximum number of selector position slots available in the editor.
✓
Programmatic Control
Access running instances. Trigger layouts. Destroy and recreate. Full control.
my-theme/js/editor-customizations.js
// Custom aspect ratios
wp.hooks.addFilter(
'ph_qlm.aspectRatioOptions',
'my-theme/ratios',
(options) => [
{
label: 'Hero Image',
value: '5/3'
},
{
label: 'Product Card',
value: '4/5'
},
{
label: 'Thumbnail',
value: '1/1'
}
]
);WordPress Plugin vs. The Alternatives
Extending Query Loop with a plugin vs. abandoning it for something else
| Feature | Custom
CSS | Custom
Blocks | Page
Builders | Query Loop
Extension |
|---|---|---|---|---|
| Uses Core Query Loop | ✓ | ✗ | ✗ | ✓ |
| Visual Controls | ✗ | ~ | ✓ | ✓ |
| True Masonry Layout | ✗ | ✓ | ✓ | ✓ |
| Lightweight | ✓ | ✓ | ✗ | ✓ |
| Developer API | ✗ | ✗ | ~ | ✓ |
| Aspect Ratio Patterns | ✗ | ✗ | ✗ | ✓ |
What WordPress Users Are Saying
Feedback from people using Query Loop + this plugin
JD
Jane D.
Theme Developer
★★★★★
“Installed the plugin, opened my Query Loop block, checked ‘Enable Masonry’. That’s it. My blog archive went from boring grid to Pinterest layout in 30 seconds.”
MB
Mike B.
Content Creator
★★★★★
“I needed masonry for my portfolio. Almost switched to a page builder. Then found this WordPress plugin. Query Loop + masonry = exactly what I wanted. No migration needed.”
SA
Sarah A.
Agency Owner
★★★★★
“Client wanted Pinterest layout for their product catalog. Query Loop was already set up. Installed this plugin, filtered the aspect ratios to ‘Product Image’ and ‘Featured’. Done. Client happy.”
Pricing
Get WP Query Loop Masonry
One WordPress plugin + your Query Loop blocks = Custom Masonry Layout.
Made by an Expert WordPress Developer
Hi! My name is Adam Husar and as a solo developer, I truly value your interest in this plugin and your support. I’m a senior Full-Stack WordPress and WooCommerce developer with over 10 years of experience working on projects for small to enterprise companies across Europe and the US.
I’ve created this plugin for everyone to use and enjoy, and I strive to constantly improve it. If you have any ideas for new features or encounter any issues, please don’t hesitate to reach out to me at adam@wpqueryloopmasonry.com.
Your feedback helps make this plugin better for everyone!
Adam Husar / Pixel Hero
