# Ajax Filter Facet

**The main filtering element that lets users filter by taxonomy, custom fields, or product attributes.**

**Content > Query Settings**

| Setting                 | Description                                                                |
| ----------------------- | -------------------------------------------------------------------------- |
| **Query Name**          | Must match your Main Query's query name                                    |
| **Meta Type**           | What to filter by: Taxonomy, Custom Field, WP Post Meta, Product Attribute |
| **Select Taxonomy**     | Choose taxonomy (category, tag, custom taxonomy)                           |
| **Select Attribute**    | For WooCommerce product attributes                                         |
| **Meta Key**            | For custom field filtering                                                 |
| **Show Top-level Only** | Only show parent terms, not children                                       |
| **Use Query Parameter** | Add filter values to URL for shareable links                               |
| **Order By Options**    | Sort options by: Name, ID, Count                                           |
| **Terms Exclude**       | Exclude specific terms from appearing                                      |

**Content > General Settings**

| Setting               | Description                                                                                                        |
| --------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Layout Type**       | Dropdown, Checkbox, Radio, or Button                                                                               |
| **Logic**             | AND (must match all) or OR (match any) - for checkbox/multiselect                                                  |
| **Multiselect**       | Allow multiple button selections                                                                                   |
| **Placeholder**       | Dropdown placeholder text                                                                                          |
| **Hide Count**        | Hide the post count next to each option                                                                            |
| **Hide Empty Option** | Hide options with no matching posts                                                                                |
| **Hide 'All' Option** | Remove the "All" option (radio/button)                                                                             |
| **Label: All**        | Customize "All" option text                                                                                        |
| **Legend Label**      | Accessibility label for checkbox/radio groups                                                                      |
| **Apply On**          | Input (immediate) or Submit (wait for button)                                                                      |
| **Child of**          | Only show terms that are children of a specific parent term. Enter the parent term ID to scope the facet.          |
| **Max depth**         | Limit how many levels deep the facet tree goes. Set to `1` for top-level only, `2` for one level of children, etc. |

**Layout Types Explained**

**Dropdown**

* Clean, space-saving
* Best for: Long lists, mobile-friendly designs
* Single selection only

**Checkbox**

* Multiple selections with AND/OR logic
* Best for: Allowing multiple filter combinations
* Shows all options at once

**Radio**

* Single selection
* Best for: Mutually exclusive options
* Includes "All" option by default

**Button**

* Visual, clickable buttons
* Can be single or multiselect
* Best for: Featured filters, visual designs

**Usage Example**

```
Filter by Category (Checkbox):
1. Add Ajax Filter Facet
2. Query Name: "blog-posts"
3. Meta Type: Taxonomy
4. Select Taxonomy: "category"
5. Layout Type: Checkbox
6. Logic: OR
7. Apply On: Input
```

#### Range slider

{% embed url="<https://drive.google.com/file/d/10PfRXxbgcLrPlTs-A5QYP0eWuA8rirX7/view?usp=sharing>" %}

#### Image and color swatches

{% embed url="<https://drive.google.com/file/d/1l4GnstUII7veo5RjVU_BCH0ibAAS39VW/view?usp=sharing>" %}