Title: Filterable Post Gallery – Post Grid &amp; WooCommerce Product Filter Block
Author: Pluximo
Published: <strong>June 26, 2025</strong>
Last modified: July 9, 2026

---

Search plugins

![](https://ps.w.org/filterable-post-gallery-block/assets/banner-772x250.png?rev
=3601437)

![](https://ps.w.org/filterable-post-gallery-block/assets/icon-256x256.png?rev=3601437)

# Filterable Post Gallery – Post Grid & WooCommerce Product Filter Block

 By [Pluximo](https://profiles.wordpress.org/pluximo/)

[Download](https://downloads.wordpress.org/plugin/filterable-post-gallery-block.1.1.0.zip)

[Live Preview](https://scn.wordpress.org/plugins/filterable-post-gallery-block/?preview=1)

 * [Details](https://scn.wordpress.org/plugins/filterable-post-gallery-block/#description)
 * [Reviews](https://scn.wordpress.org/plugins/filterable-post-gallery-block/#reviews)
 *  [Installation](https://scn.wordpress.org/plugins/filterable-post-gallery-block/#installation)
 * [Development](https://scn.wordpress.org/plugins/filterable-post-gallery-block/#developers)

 [Support](https://wordpress.org/support/plugin/filterable-post-gallery-block/)

## Description

**Filterable Post Gallery** adds a Gutenberg block that turns your posts or WooCommerce
products into a **filterable grid with category filter buttons** — no page builder,
no shortcodes, no manually adding gallery items one by one.

Pick a post type, pick a taxonomy, and the block builds the gallery for you. Publish
a new post or product and the grid updates automatically. Visitors click filter 
buttons (e.g. _All_, _Design_, _Development_, _T-Shirts_) to instantly narrow down
what they see.

#### Common uses

 * **Filterable portfolio** — show projects filtered by type, straight from a custom
   post type or categories
 * **WooCommerce product gallery** — display products in a clean grid with product-
   category filter buttons, without touching your shop templates
 * **Blog post grid with filters** — let readers browse articles by category or 
   tag instead of scrolling archives
 * **Team, services, or resources pages** — anything organized by a taxonomy works

#### Features

 * **Content-driven** — cards are generated from published posts or products; edit
   the source once and the gallery stays in sync
 * **Filter by any taxonomy** — categories, tags, WooCommerce product categories,
   or any registered custom taxonomy
 * **Two layouts** — full card (image, title, excerpt) or image-only grid for visual
   portfolios
 * **Color controls in the editor** — button background/text/hover/active states,
   card background, title, and excerpt colors
 * **Posts per page** — show 2–16 items per gallery
 * **Automatic placeholders** — posts without a featured image still look consistent
 * **Multiple galleries per page** — each block keeps its own settings
 * **Cached queries** — results are cached with transients and invalidated automatically
   on save, so the block stays light even on busy sites
 * **Responsive grid** — works on mobile, tablet, and desktop out of the box

#### How it works

 1. Add the **Filterable Post Gallery** block to any page or post
 2. Choose the source: posts or WooCommerce products
 3. Choose the taxonomy used for the filter buttons
 4. Adjust layout, colors, and posts per page
 5. Publish — new content matching your settings appears in the grid automatically

#### Video demo

#### Filterable Post Gallery vs. a normal gallery or query block

The core Gallery block requires adding and reordering images by hand, and the Query
Loop block has no visitor-facing filter buttons. This block combines both: a query-
driven grid **plus** one-click front-end filtering, configured entirely inside the
block editor.

#### Credits

[Grid icons created by Freepik – Flaticon](https://www.flaticon.com/free-icons/grid)

## Blocks

This plugin provides 1 block.

 *   Filterable Post Gallery Build a filterable gallery from posts or products instead
   of editing each gallery item by hand.

## Installation

 1. In your WordPress admin, go to **Plugins  Add New**
 2. Search for **Filterable Post Gallery**
 3. Install and activate
 4. Add the **Filterable Post Gallery** block to any page

Or upload the plugin ZIP to `/wp-content/plugins/` and activate it from the Plugins
screen.

## FAQ

### Does it work with WooCommerce?

Yes. Select **Products** as the source and **Product categories** (or any product
taxonomy) for the filter buttons. WooCommerce itself is only required if you want
to display products; the block works with regular posts without it.

### Can I filter by tags or a custom taxonomy?

Yes. Any taxonomy registered on your site can power the filter buttons — categories,
tags, product categories, or custom taxonomies added by other plugins.

### Can I show only images without titles and excerpts?

Yes. Switch the layout to image-only mode for a visual portfolio-style grid.

### Does filtering reload the page?

No. Filtering happens instantly on the front end when a visitor clicks a button.

### Can I add more than one gallery to a page?

Yes. Each block instance has independent source, taxonomy, layout, and color settings.

### Will it slow down my site?

Queries are cached using WordPress transients and the cache is cleared automatically
when content is saved. The front end loads only a small script and stylesheet.

### What happens if I deactivate the plugin?

Your content is untouched. Galleries fall back to plain post lists without the filter
buttons; no posts or products are modified or deleted.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Filterable Post Gallery – Post Grid & WooCommerce Product Filter Block” is open
source software. The following people have contributed to this plugin.

Contributors

 *   [ Pluximo ](https://profiles.wordpress.org/pluximo/)

[Translate “Filterable Post Gallery – Post Grid & WooCommerce Product Filter Block” into your language.](https://translate.wordpress.org/projects/wp-plugins/filterable-post-gallery-block)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/filterable-post-gallery-block/),
check out the [SVN repository](https://plugins.svn.wordpress.org/filterable-post-gallery-block/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/filterable-post-gallery-block/)
by [RSS](https://plugins.trac.wordpress.org/log/filterable-post-gallery-block/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1.0

 * Improved default source and taxonomy handling in the editor
 * Added clearer empty states for invalid taxonomy or empty results
 * Clarified the post-driven and product-driven workflow in the editor and readme

#### 1.0.1

 * Performance: query caching with WordPress transients, automatic cache invalidation
   on save
 * Code quality: refactored to modern JavaScript and CSS, added render helper and
   test coverage
 * UX: enhanced block editor experience

#### 1.0.0

 * Initial release: filterable grid block for posts and WooCommerce products, taxonomy-
   based filter buttons, full and image-only layouts, color customization, responsive
   grid, placeholder images, 2–16 posts per page

## Meta

 *  Version **1.1.0**
 *  Last updated **6 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.8 or higher **
 *  Tested up to **7.0.1**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/filterable-post-gallery-block/)
 * Tags
 * [filter](https://scn.wordpress.org/plugins/tags/filter/)[gallery](https://scn.wordpress.org/plugins/tags/gallery/)
   [portfolio](https://scn.wordpress.org/plugins/tags/portfolio/)[post grid](https://scn.wordpress.org/plugins/tags/post-grid/)
   [woocommerce](https://scn.wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://scn.wordpress.org/plugins/filterable-post-gallery-block/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/filterable-post-gallery-block/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/filterable-post-gallery-block/reviews/)

## Contributors

 *   [ Pluximo ](https://profiles.wordpress.org/pluximo/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/filterable-post-gallery-block/)