Quick start

Basic Setup (5 Steps)

Step 1: Create a Filter Page

1. Create a new page in Breakdance (or edit existing)

2. This page will contain your filters and results

Step 2: Add Main Query Element

1. Add the Ajax Filter Main Query element

2. Configure settings:

   • Query Name: Enter a unique identifier (e.g., products, blog-posts)

   • Post Type: Select the post type to filter

   • Posts Per Page: Number of results per page

3. Add your post cards/layout inside the Main Query

Step 3: Add Filter Facets

1. Add Ajax Filter Facet elements for each filter

2. Configure each facet:

   • Query Name: Must match your Main Query's Query Name

   • Facet Name: Display label (e.g., "Category", "Price")

   • Source: Select data source (taxonomy, meta field, etc.)

   • Filter Type: Choose display type (checkbox, radio, dropdown, range, etc.)

Step 4: Save and Index

1. Save your Breakdance page

2. Go to Woohoo Filters → Indexer in WordPress admin

3. Click Reindex All to build the filter index

4. Wait for indexing to complete (progress bar shows status)

Step 5: Test Your Filters

1. View your page on the frontend

2. Select filter options

3. Results update automatically via AJAX

Indexer feature is available since version 1.3, if you are upgrading from lower versions - watch this video: