Title: Portfolio Loop Filter
Author: blumeblau
Published: <strong>July 12, 2026</strong>
Last modified: July 12, 2026

---

Search plugins

![](https://ps.w.org/portfolio-loop-filter/assets/banner-772x250.png?rev=3605138)

![](https://ps.w.org/portfolio-loop-filter/assets/icon-256x256.png?rev=3605138)

# Portfolio Loop Filter

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

[Download](https://downloads.wordpress.org/plugin/portfolio-loop-filter.0.9.zip)

 * [Details](https://scn.wordpress.org/plugins/portfolio-loop-filter/#description)
 * [Reviews](https://scn.wordpress.org/plugins/portfolio-loop-filter/#reviews)
 *  [Installation](https://scn.wordpress.org/plugins/portfolio-loop-filter/#installation)
 * [Development](https://scn.wordpress.org/plugins/portfolio-loop-filter/#developers)

 [Support](https://wordpress.org/support/plugin/portfolio-loop-filter/)

## Description

Portfolio Loop Filter adds a dynamic block for the WordPress block editor. The block
creates filter buttons from the used terms of a selected taxonomy and filters the
next Query Loop block below it.

The plugin is designed for block themes and portfolio grids that already use the
native WordPress Query Loop block. It does not replace the Query Loop, does not 
register custom post types, and does not use AJAX on the frontend. The frontend 
script only toggles the visibility of existing Query Loop items.

Typical use cases:

 * Filter a portfolio Query Loop by project categories.
 * Filter posts by categories or tags.
 * Place multiple independent filter and Query Loop pairs on the same page.
 * Keep content management inside WordPress core blocks while adding lightweight
   frontend filtering.

Features:

 * Dynamic Gutenberg block.
 * Post type dropdown in the block settings.
 * Taxonomy dropdown based on the selected post type.
 * Automatic filter buttons from used taxonomy terms.
 * Filters only the next Query Loop below the filter block.
 * Optional “All” button.
 * Button alignment: left, center or right.
 * Color controls for text, active text, border, background, active background and
   hover/focus border.
 * Fallback styles when no custom colors are selected.

## Blocks

This plugin provides 1 block.

 *   Portfolio Loop Filter Creates filter buttons from used taxonomy terms and filters
   only the next Query Loop below the block.

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/portfolio-loop-filter/` directory
    or install the plugin ZIP through the WordPress plugins screen.
 2. Activate the plugin through the “Plugins” screen in WordPress.
 3. Edit a page or template that contains a Query Loop block.
 4. Insert the “Portfolio Loop Filter” block directly above the Query Loop that should
    be filtered.
 5. Select the post type and taxonomy in the block sidebar.
 6. Save the page or template.

## FAQ

### Does this plugin create a portfolio post type?

No. It intentionally does not register custom post types or taxonomies. You can 
use WordPress posts, ACF-generated post types, or any other public post type that
appears in the block settings.

### Does the plugin replace the Query Loop block?

No. The native WordPress Query Loop block remains responsible for rendering the 
grid. This plugin only adds filter buttons and a small frontend script.

### Can I use multiple filters on one page?

Yes. Each filter block controls the next Query Loop block below it. Use the structure“
Filter, Query Loop, Filter, Query Loop” when placing multiple filterable grids on
the same page.

### Why do some terms not appear as buttons?

The block only renders terms that are used by published posts of the selected post
type. On the frontend, buttons without a matching item in the next Query Loop are
hidden automatically.

### Does the frontend filtering reload the page?

No. The plugin filters existing items in the browser. It does not perform frontend
AJAX requests.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Portfolio Loop Filter” is open source software. The following people have contributed
to this plugin.

Contributors

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

[Translate “Portfolio Loop Filter” into your language.](https://translate.wordpress.org/projects/wp-plugins/portfolio-loop-filter)

### Interested in development?

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

## Changelog

#### 0.9

 * Added the Portfolio Loop Filter block.
 * Added post type and taxonomy dropdowns.
 * Added automatic taxonomy term buttons.
 * Added next Query Loop targeting for multiple independent filter and loop pairs.
 * Added button alignment controls.
 * Added color controls and fallback styles.
 * Added WordPress.org-style plugin headers, readme and GPL license information.

## Meta

 *  Version **0.9**
 *  Last updated **9 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.3 or higher **
 *  Tested up to **7.0.1**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/portfolio-loop-filter/)
 * Tags
 * [block](https://scn.wordpress.org/plugins/tags/block/)[gutenberg](https://scn.wordpress.org/plugins/tags/gutenberg/)
   [portfolio](https://scn.wordpress.org/plugins/tags/portfolio/)[query loop](https://scn.wordpress.org/plugins/tags/query-loop/)
   [taxonomy filter](https://scn.wordpress.org/plugins/tags/taxonomy-filter/)
 *  [Advanced View](https://scn.wordpress.org/plugins/portfolio-loop-filter/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/portfolio-loop-filter/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/portfolio-loop-filter/reviews/)

## Contributors

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

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/portfolio-loop-filter/)