Description
Query Loop Masonry Lite transforms your WordPress Query Loop blocks into stunning masonry and Pinterest-style layouts. Built specifically for the WordPress block editor, this plugin works seamlessly with core blocks – no proprietary markup, no vendor lock-in.
What is Masonry Layout?
Masonry layout arranges items in a grid where each item flows into the next available space, like bricks in a wall. Unlike traditional grids with fixed row heights, masonry creates dynamic, visually engaging layouts where content of varying heights fits together perfectly.
Features
- Masonry Layout – Transform any Query Loop into a beautiful Pinterest-style grid
- Works with Core Blocks – Uses native WordPress Query Loop blocks
- No Vendor Lock-in – Standard WordPress markup, easy to switch or customize
- Lightweight – Optimized Masonry.js library with minimal footprint
- Responsive – Automatically adapts to different screen sizes
Any Issues or Bugs?
This plugin was created by a solo developer who genuinely cares about quality. If you encounter any issues or something isn’t working as expected, please use the WordPress.org support forums on this page and open a support topic before leaving a negative rating.
I actively maintain this plugin to work with the latest WordPress codebase and I’m very responsive to user feedback. Give me a chance to help you – most issues can be resolved quickly!
How It Works
- Create or edit a Query Loop block
- Switch to Grid layout in the toolbar
- Set Grid Item Position to Manual
- Enable Masonry in the block sidebar
- Your posts now display in a beautiful masonry layout
Upgrade to Premium
Query Loop Masonry Premium unlocks the full potential of masonry layouts with advanced controls:
Responsive Breakpoints
Set different layouts for 6 screen sizes – Mobile, Small, Medium, Large, Wide, and Huge. Perfect responsive control for any device.
Column Control
Define 1-16 columns per breakpoint. Create layouts that adapt beautifully from mobile to desktop.
Aspect Ratio Rules
Control image aspect ratios with 7 presets: Square (1:1), Portrait (3:4, 2:3), Landscape (4:3, 3:2, 16:9), and Ultra Wide (21:9).
Column Span
Make featured posts span multiple columns for visual hierarchy and emphasis.
Advanced Targeting
Target “Every Nth” item or “Only” specific positions. Choose between “in a Row” or “in this Grid” targeting modes.
One-Time Payment, Lifetime License
No subscriptions. No monthly fees. No hidden costs. Pay once and get lifetime access to updates and priority support.
Installation
- Upload the plugin files to the
/wp-content/plugins/ph-queryloop-masonry-litedirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Create or edit a page with a Query Loop block.
- In the block toolbar, switch from List view to Grid view.
- In the block sidebar under Layout, set Grid Item Position to “Manual”.
- In the Masonry Settings panel, check “Enable Masonry Grid”.
- Your Query Loop now displays as a masonry layout.
FAQ
-
What is masonry layout?
-
Masonry layout is a grid layout where items are arranged to fill available vertical space, similar to how a mason fits stones in a wall. Items of different heights flow together without gaps, creating a visually dynamic Pinterest-style layout.
-
Which blocks does this plugin work with?
-
Query Loop Masonry Lite works with the core WordPress Query Loop block (core/post-template). It extends the native block with masonry layout capabilities while maintaining full compatibility with WordPress.
-
Why do I need Grid layout with Manual positioning?
-
The plugin requires Grid layout with Manual positioning because masonry needs to know the intended column count. Manual positioning tells WordPress to use a specific grid structure that the masonry JavaScript can then enhance.
-
Does this work with Full Site Editing (FSE) themes?
-
Yes! Query Loop Masonry works with any theme that supports the block editor, including Full Site Editing themes. Use it in templates, template parts, or regular posts and pages.
-
Will my content still look good if I deactivate the plugin?
-
Yes. The plugin uses standard WordPress markup with no proprietary elements. If you deactivate the plugin, your Query Loop will simply display as a regular grid without the masonry effect.
-
Lite version provides basic masonry layout functionality – enable masonry on any Query Loop block and it just works.
Premium version adds advanced controls: 6 responsive breakpoints, per-breakpoint column settings, aspect ratio rules, column span, advanced targeting modes (Every/Only, Row/Grid), and priority support with lifetime updates.
-
Visit wpqueryloopmasonry.com to purchase a lifetime license. Premium is a one-time payment with no subscriptions or recurring fees.
-
Where can I get support?
-
For Lite version support, please use the WordPress.org support forums.
For Premium support, visit wpqueryloopmasonry.com.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Query Loop Masonry Lite” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Query Loop Masonry Lite” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
- Basic masonry layout for Query Loop blocks
- Automatic responsive behavior
- Lightweight Masonry.js implementation
