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