> For the complete documentation index, see [llms.txt](https://docs.woohoo.dance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.woohoo.dance/ajax-filters/elements/ajax-filter-search.md).

# Ajax Filter Search

**Live search input that filters results by post title/content.**

**Content > Query Settings**

| Setting        | Description                |
| -------------- | -------------------------- |
| **Query Name** | Must match your Main Query |

**Content > General Settings**

| Setting             | Description                                        |
| ------------------- | -------------------------------------------------- |
| **Apply On**        | Input (live search) or Submit (button click)       |
| **Debounce (ms)**   | Delay before search triggers (default: 300ms)      |
| **Min Characters**  | Minimum characters to start searching (default: 3) |
| **Placeholder**     | Input placeholder text                             |
| **Show Clear Icon** | Show X button to clear search                      |

**Design Settings**

* Input width, padding, borders, typography
* Hover/Focus/Active states
* Clear icon customization
* Transition duration

**Important Notes**

* Only use ONE search element per query
* For "Submit" mode, pair with Ajax Filter Submit button
* Escape key clears search
* Enter key triggers immediate search (in Input mode)

**Usage Example**

```
Live Search:
1. Add Ajax Filter Search
2. Query Name: "blog-posts"
3. Apply On: Input
4. Debounce: 300ms
5. Min Characters: 3
6. Placeholder: "Search posts..."
```