# Troubleshooting

#### Elements Not Connected

**Problem**: Filters don't affect the main query

**Solution**: Verify all elements have identical Query Name (case-sensitive, no spaces)

#### Search Not Working with Submit Button

**Problem**: Apply button doesn't include search value

**Solution**: Ensure Search element's "Apply On" is set to "Submit"

#### Infinite Scroll Not Working

**Problem**: Posts don't load when scrolling

**Solutions**:

1. Remove any Pagination or Load More elements
2. Check console for conflict warnings
3. Adjust scroll offset if page is already scrolled

#### Filter Options Missing

**Problem**: Expected taxonomy terms not showing

**Solutions**:

1. Disable "Hide Empty Options" temporarily
2. Check "Show Top-level Only" setting
3. Review "Terms Exclude" list
4. Ensure posts are assigned to those terms

#### Sort Not Reflecting Visually

**Problem**: Sort is applied but UI doesn't show selection

**Solution**: This was a known bug. Ensure you have the latest plugin version where Sort facet UI initializes correctly on page load.

#### Loading State Stuck

**Problem**: Element stays in loading state

**Solutions**:

1. Check browser console for JavaScript errors
2. Verify AJAX endpoint is accessible
3. Check for PHP errors in WordPress debug log


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.woohoo.dance/ajax-filters/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.