Quick Start

Create your first facet filter and grid in under 10 minutes.

1

Open the FilterX Admin

After installing and activating FilterX, you'll see a FilterX menu in your WordPress admin sidebar (with a slider icon). Click it to open the main dashboard.

Tip: You can also navigate directly to /wp-admin/?page=filterx
2

Create Your First Facet

A Facet is a single filter control (e.g., checkbox list for categories, a price range slider). Each facet maps to a data source.

  1. 1Go to FilterX → Facets in the admin menu.
  2. 2Click New Facet.
  3. 3Fill in the details:
    • Name (e.g.
    • Product Category)
    • Slug (auto-suggested)
    • Type (e.g.
    • Checkbox)
    • Source (e.g.
    • taxonomy)
    • Source Key (e.g.
    • product_cat or category)
  4. 4Set the Post Type to filter (e.g., post or product).
  5. 5Click Save. The facet is now active.
After creating a facet, FilterX will queue a background indexing job to populate the filterx_index table with values from your posts.
3

Create a Grid

A Grid is the results display area — it queries your posts and renders them as cards with optional pagination.

  1. 1Go to FilterX → Grids and click New Grid.
  2. 2Enter a Grid Name and a unique Slug (e.g., product-grid).
  3. 3Choose a Layout: Grid, Masonry, List, Carousel, or Table.
  4. 4Set the Source Type to post_type and select your post type (e.g., product).
  5. 5Configure Items Per Page (e.g., 12) and Columns (e.g., 3).
  6. 6Optionally assign a Card Template for custom card design.
  7. 7Click Save.
4

Place on a Page

Use the shortcode to embed FilterX on any page or post:

// Show grid + its associated facets

[filterx_grid id="your-grid-slug"]

// Show only specific facets

[filterx_facets grid="your-grid-slug"]

// Show only the results area

[filterx_results grid="your-grid-slug"]

You can also use the FilterX Grid Gutenberg block or the FilterX Widget in Elementor.

5

Check the Index Status

Before filters work, the indexer must have processed your posts. Go to FilterX → Index Status to see progress. You can also trigger a full re-index from there.

Once indexed, your site visitors can filter instantly — with no full database scans. Results appear via the REST API in milliseconds.

What You've Just Done

🏷️
Facet Created
Maps to a taxonomy or meta field
📋
Grid Created
Queries and displays filtered posts
📄
Shortcode Placed
Renders the UI on your page