# 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>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.woohoo.dance/ajax-filters/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.