Best Practices

Performance

  1. Enable "Hide Empty Options" on facets to reduce clutter

  2. Use reasonable Posts Per Page (6-12 for grids, 10-20 for lists)

  3. Set appropriate Debounce for live search (300-500ms)

  4. Avoid multiple identical queries on the same page

User Experience

  1. Use Submit mode for complex filter combinations

  2. Always include Reset button for easy clearing

  3. Show result counts to indicate filter impact

  4. Use loading indicators for feedback during AJAX

  5. Choose appropriate layout types:

    • Few options (2-5): Buttons or Radio

    • Many options (5+): Dropdown or Checkbox

SEO & Sharing

  1. Enable "Use Query Parameter" on important facets for shareable URLs

  2. Use Ajax Search Term to display search context

  3. Include Query Count/Summary for result context

Conflicts to Avoid

  • Don't combine Infinite Scroll with Pagination or Load More

  • Use only ONE Search element per query

  • Ensure all elements share exact same Query Name

PreviousTroubleshootingNextTroubleshooting

Last updated