# 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
