ShelfBuilder Lite

Description

ShelfBuilder Lite is a Gutenberg block plugin that lets you create curated, hand-picked grids with full drag-and-drop ordering. Unlike query-based blocks that automatically pull content, ShelfBuilder gives you complete control over which items appear and in what order.

How it works:

  1. Add the ShelfBuilder block to any page or post
  2. Choose a content type (Posts, Pages, or custom post types)
  3. Pick specific items from a searchable, scrollable list
  4. Drag and drop to arrange them in your preferred order
  5. Customize the grid layout with sidebar controls

Features:

  • Drag-and-drop grid ordering with visual gap indicators
  • Searchable item picker with tag filtering
  • Customizable columns (1-6), gap spacing, and card max width
  • Image aspect ratio options (square, landscape, wide, portrait)
  • Text alignment controls (left, center, right)
  • Grid padding for centered layouts
  • Responsive design (2 columns on tablet, 1 on mobile)
  • Lightweight — no jQuery dependency, minimal CSS, zero frontend JavaScript

Looking for WooCommerce support?

ShelfBuilder Pro adds WooCommerce products, product categories, product tags, pricing display, item counts, add-to-cart buttons, hierarchical category browsing, and product tag filtering — all for a one-time $1 purchase.

Screenshots

  • The drag-and-drop grid editor with visual reordering
  • Sidebar controls for content source and item selection
  • Grid settings with columns, gap, padding, and card width options
  • A rendered grid on the frontend

Blocks

This plugin provides 1 block.

  • ShelfBuilder Lite

Installation

  1. Upload the shelfbuilder-lite folder to /wp-content/plugins/
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Add the “ShelfBuilder Lite” block to any page or post using the block editor

FAQ

Does this work with the block editor only?

Yes, ShelfBuilder is a Gutenberg block. It requires WordPress 6.0 or later with the block editor enabled.

Can I use this with WooCommerce products?

The Lite version supports Posts, Pages, and non-WooCommerce custom post types. For WooCommerce product grids, product categories, pricing, and add-to-cart buttons, check out ShelfBuilder Pro.

How many items can I add to a grid?

There is no hard limit. The item picker loads up to 200 items per content type, and you can select as many as you need.

Does this add any scripts to my frontend?

No. ShelfBuilder renders pure HTML and CSS on the frontend with zero JavaScript. The drag-and-drop editor interface only loads in the block editor.

Can I have multiple ShelfBuilder blocks on one page?

Yes, each block is independent with its own content type, item selection, and layout settings.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“ShelfBuilder Lite” is open source software. The following people have contributed to this plugin.

Contributors

Translate “ShelfBuilder 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
  • Drag-and-drop grid block with pointer-event-based reordering
  • Searchable item picker with tag filtering
  • Support for Posts, Pages, and custom post types
  • Customizable columns, gap, aspect ratio, text alignment
  • Grid padding and card max width controls
  • Responsive frontend layout
  • Vertical gap indicator during drag operations