> For the complete documentation index, see [llms.txt](https://docs.woohoo.dance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.woohoo.dance/ajax-filters/quick-start.md).

# 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

{% hint style="info" %}
Indexer feature is available since version 1.3, if you are upgrading from lower versions - watch this video:
{% endhint %}

{% embed url="<https://drive.google.com/file/d/1qfBagYpfO3Ip4ZmJnA6wsw0BDZgkgfP4/view?usp=sharing>" %}