---
title: "Query Loop Filter"
canonical: "https://kb.uconn.edu/space/IKB/28677308427/Query%20Loop%20Filter"
format: markdown
---
## Description 

This plugin creates a WordPress Gutenberg block for the <u>[Cynder theme](https://aurora.uconn.edu/themes/)</u> that allows visitors to sites to filter posts by taxonomy terms such as **categories** or **tags**. Please consult the <u>[Aurora Block Editor Training](https://aurora.uconn.edu/block-editor/training/)</u> for details on how to use the Gutenberg editor in general. 

This block works with an “opt-in” model together with <u>[WordPress’s Query block](https://wordpress.org/documentation/article/query-loop-block/)</u>. The block does not configure itself automatically. Site admins will need to make choices about how the block should be configured. 

> ℹ️ The query loop filter block **only **works with the Core Query Loop block. No other loop blocks, like the “Recent Posts” block, will work with it. The instructions below outline how to use the Core Query Loop block

## Usage 

### Adding and configuring the Query Loop block 

1. Add a Query Loop block to your page

![image-20260421-140614.png](media://11ec5231-11e8-45bb-b8d1-34c6a9a044b8)

2. Configure the Post Template section as appropriate to your site. Please see the other documentation resources for details.
3. Ensure that you are querying the type of posts you want (e.g. Post as opposed to Page)

![image-20260421-140854.png](media://e70c454a-9c22-4671-8b2a-c7403f441f31)

4. Click on the “Filters” section of the Query Loop block and choose “Taxonomies”
5. Select taxonomies such as categories for the query. You may choose to use one or more taxonomies either alone or in combination. You **must** opt-in to have the display to visitors (see below)

![image-20260421-141130.png](media://80c35e72-096f-4fab-aa4e-b91bb0ab0513)


### Adding and configuring the Query Filter block 

1. The Query Filter block can **only **be added to the page from within a Query block. The easiest way to do this is to
  1. Select the page outline view
  2. Select “Post Template”
  3. Select “Add before”

![image-20260421-141424.png](media://fd88ab1f-ba42-4276-93bc-abac8d1b52bc)

You can then type “/” followed by “Query Loop Filter” to find the block 

![image-20260421-141644.png](media://277af091-3d55-4ca9-9cd5-0a846c30e322)

1. The filter block should then automatically associate itself with the parent Query Loop block
2. You may now configure which of the taxonomies visitors will be presented with to filter by. Any taxonomies which the site admin has not included in the parent Query Loop will be visible but not available for selection.

![image-20260421-141850.png](media://99dacd14-94aa-46af-9557-945099d133a5)

You may also choose to show or hide the “Reset” button and its text. By default the button is enabled.   


## Block Styles 

On Aurora, there are currently three styles available. They are  

- Default Aurora Buttons
- Small Royal Blue Pills
- Small Cool Grey Pills