Title: FilterWell – Query Loop Filters
Author: Raúl Cerda
Published: <strong>3 de Noviembre de  2026</strong>
Last modified: 3 de Noviembre de  2026

---

Buscar plugins

![](https://ps.w.org/filterwell/assets/banner-772x250.png?rev=3782592)

![](https://ps.w.org/filterwell/assets/icon.svg?rev=3782592)

# FilterWell – Query Loop Filters

 Por [Raúl Cerda](https://profiles.wordpress.org/raulcerda/)

[Descargar](https://downloads.wordpress.org/plugin/filterwell.1.0.1.zip)

 * [Detalles](https://cl.wordpress.org/plugins/filterwell/#description)
 * [Reseñas](https://cl.wordpress.org/plugins/filterwell/#reviews)
 *  [Instalación](https://cl.wordpress.org/plugins/filterwell/#installation)
 * [Desarrollo](https://cl.wordpress.org/plugins/filterwell/#developers)

 [Soporte](https://wordpress.org/support/plugin/filterwell/)

## Descripción

FilterWell adds filtering blocks that connect to the core **Query Loop** block. 
Visitors can search, sort and filter posts, pages or custom post types, and the 
results update without reloading the page, using the WordPress Interactivity API.

Everything is built with native blocks and takes its look from your theme: fonts,
colors, buttons and form fields follow the Styles you already defined.

#### Blocks

 * **Query Loop Filters** – the container. It connects to a Query Loop and decides
   whether filters apply instantly or with a “Filter” button. On mobile, it can 
   show the filters in a slide-in panel.
 * **Taxonomy Filter** – categories, tags or any taxonomy, shown as checkboxes, 
   single choice, a dropdown or a row of pills. Includes result counts that take
   the other active filters into account and can hide options without results. For
   hierarchical taxonomies it can show only the main terms, or only the subterms
   of the selected term.
 * **Author Filter** – the same styles, listing the authors that have published 
   content.
 * **Date Filter** – a publish date range (from / to).
 * **Query Loop Search** – a text search field that uses your theme’s Search block
   style.
 * **Query Loop Sort** – a dropdown to sort by newest, oldest, title, recently updated
   or most commented. You choose the options and their labels.

Need only a search field or a sort dropdown next to your loop? Insert **Query Loop
Search** or **Query Loop Sort** anywhere on the page: they come already wrapped 
in their own Query Loop Filters block.
 * **Filter Buttons** – “Filter” and “Clear”
buttons. * **Active Filters** – the applied filters as removable chips.

#### Highlights

 * **Pills row**: a single scrollable row with arrows and fading edges, which can
   also be swiped on mobile.
 * **Category and subcategory rows**: a first row with the main categories and a
   second row, shown only when needed, with the subcategories of the selected one.
 * **Archive pages**: on a category, tag, taxonomy or author archive, the current
   term is marked as selected and choosing another one goes to its archive URL. 
   On date archives (`/2025/09/`), the Date Filter shows that period.
 * **Shareable URLs**: filters are stored in the URL, so filtered results can be
   shared and the browser back and forward buttons work.
 * **Several loops per page**: name your loops and choose which one each set of 
   filters controls. You can also add filters directly from the Query Loop sidebar.
 * **Accessible**: real form controls, keyboard support, a focus-trapped mobile 
   panel and screen reader announcements when results change.
 * **No settings page and no database tables.**

## Capturas de pantalla

[⌊A pills row with sorting on the left and a "Filters" button on the right.⌉⌊A pills
row with sorting on the left and a "Filters" button on the right.⌉[

A pills row with sorting on the left and a “Filters” button on the right.

[⌊The slide-in filters panel with search, author, date and tags.⌉⌊The slide-in filters
panel with search, author, date and tags.⌉[

The slide-in filters panel with search, author, date and tags.

[⌊Taxonomy Filter settings: style, arrows, counts and colors.⌉⌊Taxonomy Filter settings:
style, arrows, counts and colors.⌉[

Taxonomy Filter settings: style, arrows, counts and colors.

[⌊The Query Loop Filters panel inside the Query Loop block.⌉⌊The Query Loop Filters
panel inside the Query Loop block.⌉[

The Query Loop Filters panel inside the Query Loop block.

[⌊Two rows: main categories and the subcategories of the selected one.⌉⌊Two rows:
main categories and the subcategories of the selected one.⌉[

Two rows: main categories and the subcategories of the selected one.

## Bloques

Este plugin proporciona 7 bloques.

 *   Filtros activos Muestra los filtros aplicados como etiquetas que se pueden 
   quitar y un botón para limpiarlos todos.
 *   Filtro por fecha Filtra el bucle por un rango de fechas de publicación (desde/
   hasta). Usa el estilo de campo del bloque Buscar del tema.
 *   Filtros de bucle Contenedor de filtros conectado a un Bucle de consulta. Filtra
   con botón o en tiempo real y, en móvil, se muestra en un panel deslizable.
 *   Ordenar bucle Desplegable para ordenar el Bucle de consulta conectado: más 
   recientes, más antiguos, por título o más comentados. Se aplica al instante.
 *   Botones de filtros Botón "Filtrar" para aplicar los filtros (en modo tiempo
   real se oculta). Opcionalmente, un enlace "Limpiar".
 *   Buscador del bucle Campo de búsqueda por texto para el Bucle de consulta conectado.
   Usa el mismo estilo que el bloque Buscar del tema.
 *   Filtro por taxonomía Filtra el bucle por categorías, etiquetas o cualquier 
   taxonomía del tipo de contenido.

## Instalación

 1. Install the plugin from the Plugins screen, or upload the `filterwell` folder to`/
    wp-content/plugins/`.
 2. Activate the plugin.
 3. In the block editor or the Site Editor, add a **Query Loop** block.
 4. Select the Query Loop and, in its **Query Loop Filters** panel, click **Add filters
    above the loop**. You can also insert the **Query Loop Filters** block anywhere
    and choose the loop in its **Connection** panel.
 5. Add the filter blocks you need inside the container.

## FAQ

### Does it work with custom post types and custom taxonomies?

Yes. The Taxonomy Filter lists the taxonomies of the post type used by the connected
Query Loop.

### Can the filters and the loop be in different places?

Yes. The container can be anywhere on the page or template. If the loop is outside
the current content (for example, in the template while the filters are in a page),
type the loop ID in **Loop ID (manual)**.

### What happens on archive pages?

On `/category/design/`, for example, the category filter shows _Design_ as selected
and the loop only shows those posts. Choosing another category goes to its archive
URL, keeping the other filters. Loops that inherit the template query always do 
this. Loops with their own query do it when **Follow the current archive** is enabled
in the container.

On date archives such as `/2025/09/`, the Date Filter shows the first and last day
of that month. Changing the dates keeps loops with their own query on the same page
with the new range, and takes loops that inherit the template query to the posts
page.

### How do I show categories and subcategories in two rows?

Add two Taxonomy Filter blocks for Categories, each one in its own Query Loop Filters
container. Set **Terms to show** to _Top-level terms only_ in the first one and 
to _Subterms of the selected term_ in the second one. The second row stays hidden
until a category with subcategories is selected.

### How is “most commented” sorting calculated?

It uses the number of approved comments of each post. WordPress does not track views,
so there is no “most viewed” option.

### Does it work without JavaScript?

In “With button” mode (the default), the filters are a regular form, so they keep
working with a normal page load. Instant mode, the pills row arrows and the mobile
panel need JavaScript.

### Where is the source code of the JavaScript and CSS files?

The plugin includes the source files in the `src` folder, next to the compiled files
in `build`. To compile them, run `npm install` and then `npm run build` in the plugin
folder. The build uses the official `@wordpress/scripts` package, listed in `package.
json`.

## Reseñas

No hay reseñas para este plugin.

## Colaboradores & Desarrolladores

“FilterWell – Query Loop Filters” es software de código abierto. Las siguientes 
personas han contribuido a este plugin.

Colaboradores

 *   [ Raúl Cerda ](https://profiles.wordpress.org/raulcerda/)

“FilterWell – Query Loop Filters” ha sido traducido en 1 idioma. Gracias a [los traductores](https://translate.wordpress.org/projects/wp-plugins/filterwell/contributors)
por sus contribuciones.

[Traduce “FilterWell – Query Loop Filters” a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/filterwell)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/filterwell/), echa
un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/filterwell/), 
o suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/filterwell/)
por [RSS](https://plugins.trac.wordpress.org/log/filterwell/?limit=100&mode=stop_on_copy&format=rss).

## Historial de cambios

#### 1.0.1

 * New: “Query Loop Sort” and “Query Loop Search” can be inserted anywhere on the
   page, on their own. They connect to the loop like the full filters block.
 * New: the default Query Loop Filters block now includes the sort dropdown.
 * Fix: sorting by title ignores leading punctuation, so “¿Cómo…?” is listed with
   the C titles. This also applies to loops sorted by title by default.
 * New: all FilterWell blocks are grouped in their own “FilterWell” section of the
   block inserter.

#### 1.0.0

 * First public release.

## Meta

 *  Versión **1.0.1**
 *  Última actualización **hace 1 día**
 *  Instalaciones activas **Menos de 10**
 *  Versión de WordPress ** 6.8 o superior **
 *  Probado hasta **7.1.4**
 *  Versión de PHP ** 7.4 o superior **
 *  Idiomas
 * [English (US)](https://wordpress.org/plugins/filterwell/) y [Spanish (Chile)](https://cl.wordpress.org/plugins/filterwell/).
 *  [Traducir a tu idioma](https://translate.wordpress.org/projects/wp-plugins/filterwell)
 * Etiquetas
 * [block](https://cl.wordpress.org/plugins/tags/block/)[filter](https://cl.wordpress.org/plugins/tags/filter/)
   [query loop](https://cl.wordpress.org/plugins/tags/query-loop/)[search](https://cl.wordpress.org/plugins/tags/search/)
   [taxonomy](https://cl.wordpress.org/plugins/tags/taxonomy/)
 *  [Vista Avanzada](https://cl.wordpress.org/plugins/filterwell/advanced/)

## Calificaciones

Aún no se han enviado valoraciones.

[Tu reseña](https://wordpress.org/support/plugin/filterwell/reviews/#new-post)

[Ver todas las reseñas](https://wordpress.org/support/plugin/filterwell/reviews/)

## Colaboradores

 *   [ Raúl Cerda ](https://profiles.wordpress.org/raulcerda/)

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/filterwell/)