Getting Started with
FilterKit Pro

• WooCommerce → FilterKit Pro — Your dashboard. Manage filters, reorder them, change types, edit labels.
• WooCommerce → FilterKit Analytics — Your analytics dashboard with 7 tabs of customer data.
• WooCommerce → Settings → FilterKit Pro — All your settings: General, SEO & URLs, Features, Comparison, Advanced, and License.

• Color Swatches — Round clickable color circles. The plugin reads the color code from your WooCommerce attribute — if you have a "Red" term with color #ef4444, it shows a red circle. Best for Color attributes.
• Image Swatches — Square thumbnail tiles. Upload an image for each option. Great for materials (leather, cotton), patterns (stripes, plaid), or anything where a picture says more than a word.
• Price Slider — Two draggable handles on a bar. The plugin reads your cheapest and most expensive products automatically. Customers drag to set their budget and see numbers update in real time.
• Checkboxes — Pick as many as you want. Each option shows how many products match. Best for categories, brands, tags — anything where customers want multiple selections.
• Radio Buttons — Pick only one. Good for either-or choices like Gender (Men / Women / Kids) or Condition (New / Used / Refurbished).
• Searchable Dropdown — A dropdown with a search box at the top. Perfect when you have lots of options — like a Brand filter with 50+ brands.
• Star Rating — Filter by customer review rating. Shows stars (5 stars, 4 stars, etc.) with how many products match each level. Requires WooCommerce reviews to be enabled.
• Toggle Switch — A simple on/off switch. Perfect for "On Sale," "In Stock," "Free Shipping," or "Featured." Takes very little sidebar space.
• Category Tree — An expandable list showing your category hierarchy. Click the arrow to see subcategories. Drill down without leaving the page.

A built-in sort dropdown lets customers sort by price (low/high), popularity, average rating, newest, or alphabetical. It appears alongside your filters automatically.

If a filter has 50+ options, you can keep it manageable. Set these per filter in WooCommerce → FilterKit Pro → click on any filter → Overflow Settings:

• Scrollable Container — Set a max height and the list scrolls within it
• Search Within Filter — Adds a small search box at the top of that filter
• "Show More" Toggle — Shows the first few, then a "Show 47 more" link to expand
• All Three Combined — Use all three together for the best experience

Choose the look that matches your store: Default, Editorial, Soft, Dots, Bold, Pills, or Heatmap (uses color intensity to show stock levels).

Use the shortcode anywhere on your site:

• [filterkit_matrix_filter] — Displays the matrix grid. Availability is checked in real time, so customers never see combinations they can't buy.

Copy and paste these into any page, post, or widget area:

• [filterkit_filters] — Shows the full filter sidebar.
• [filterkit_filtered_products] — Shows the product grid that updates when filters are used. Pair with the sidebar shortcode for a custom shop layout.
• [filterkit_active_filters] — Shows the active filter chips — little tags like "Color: Red ×" that customers can click to remove. Place above your product grid.
• [filterkit_search_bar] — Shows the smart search bar. Put it in your header, above the shop, or anywhere else.
• [filterkit_sort] — Shows a standalone sort dropdown. Useful when you want sorting placed separately from filters.
• [filterkit_matrix_filter] — Shows the Size × Color matrix grid.

If you use the WordPress block editor, search for "FilterKit" in the block inserter. Four blocks are available:

• Product Filter Sidebar — Same as the filter shortcode, with a live preview in the editor.
• Filtered Products Grid — The product grid. Preview updates as you change settings.
• Active Filter Chips — The active filter tag bar.
• Smart Product Search — The smart search bar block.

All four blocks work with Full Site Editing (FSE) — place them in your theme's shop template, archive template, or any custom template.

If you use Elementor, Divi, Bricks, or another supported page builder, FilterKit Pro has native drag-and-drop widgets for each. Look for "FilterKit" in your builder's widget panel.

When a customer types a keyword like "jacket," matching products appear instantly in a dropdown — no page reload needed.

Customers can type full sentences like "red leather jacket under $200 in medium" and the search bar understands what they mean:

• Color → Red
• Material → Leather
• Category → Jacket
• Price → Under $200
• Size → Medium

Filters activate automatically and the product grid updates. It even handles typos — "blek jacket" still matches "black jacket."

Three key numbers: how many times filters were used, what percentage of filter users ended up buying something, and how much revenue came from filter users. Below that, a usage trend chart and a list of your most popular filters.

Every search and filter combination that returned zero products, sorted by frequency. This shows you what customers want that you don't have. Example: "23 people searched for 'wireless earbuds under $30' — 0 results."

Similar to Zero Results, but focused on filter combinations. If 15 people tried "Red + XL + Jacket" and got nothing, this tab surfaces that. It groups similar searches together, shows week-over-week trends, and suggests similar products you already stock. You can create a draft product from any gap with one click, or export the full table as a CSV file.

Every customer who left their email on a zero-results page. Shows their email, what they wanted, when they signed up, and whether they've been notified.

The full journey: filter clicked → product viewed → added to cart → purchase completed. See which filter paths lead to sales and which are dead ends.

How much money each filter helped generate. If Color brought in $2,840 and Size brought in $1,920, you know Color is more valuable and deserves a more prominent position.

Plain English suggestions based on your data. Things like: "Move the Brand filter up — it's your 3rd highest earner." Or: "43 customers searched for 'Organic' — consider adding it as an attribute." Or: "14 people waiting for Red XL Jackets — consider restocking."

Every tab has an Export CSV button. Click it and the download starts immediately. Useful for sharing with your team or analyzing in a spreadsheet.

Fine-tune how analytics work in WooCommerce → Settings → FilterKit Pro → Features:

• Data Retention — Choose how many days of data to keep (7 to 365 days). Older data is automatically deleted. Important for privacy compliance.
• Exclude Admin Sessions — Turn this on so your own browsing doesn't appear in analytics. Recommended.
• Track Guests / Track Users — Choose whether to track non-logged-in visitors, logged-in customers, or both.

Show a filter only on specific categories. "Brand" only on Electronics, "Size" only on Clothing, "Storage" only on Phones. Each category page gets only the relevant filters.

Show on desktop, mobile, or both. Most stores show 6–8 filters on desktop and 2–3 on mobile to keep things clean on small screens.

Make filters depend on each other. Hide "Sub-Category" until the customer picks a main "Category." Hide "Size" until they select "Clothing." Keeps the sidebar short until the customer starts narrowing down.

If only 2 products in a category have a "Material" attribute, showing a Material filter there is pointless. Set a minimum (say, 5) and the filter hides itself automatically on pages with too few matching products.

• Before: yourstore.com/shop/?filter_color=red&filter_size=large&min_price=50&max_price=200
• After: yourstore.com/shop/color-red/size-large/under-200/

• Creates proper page titles for each filtered page (e.g., "Red Large Jackets – YourStore" in Google results)
• Generates page descriptions summarizing the filtered products
• Prevents duplicate content — so Google doesn't see your shop as 500 identical pages
• Creates a sitemap of popular filter combinations so Google discovers and indexes them

• Headline numbers — filter uses, conversion rate, and revenue — with changes vs. last period
• What customers searched for that you don't stock
• Top filters ranked by revenue
• New waitlist signups
• Actionable recommendations

Get notified when a search hits a threshold. For example, if 10 people search for something you don't stock in a single day, you can get an alert immediately, as a daily digest, or weekly. Set the threshold and frequency in WooCommerce → Settings → FilterKit Pro → Features.

• Filter Button — A "Filters" button at the top of the shop (e.g., "Filters (3)") replaces the sidebar.
• Bottom Sheet — Tapping opens a panel that slides up from the bottom — like Google Maps or iPhone apps. Swipe down to close.
• Touch Optimized — Larger color swatches, touch-drag price slider, bigger tap areas for checkboxes.
• Sticky Apply Bar — A fixed bar at the bottom shows "Show X products" and "Clear all" with a real-time product count.

• A "Compare" checkbox appears on each product card in your shop
• Check 2–8 products to compare
• A sticky bar at the bottom shows selected products
• Click "Compare" for a full side-by-side table: price, attributes, rating, stock, description
• "Show only differences" toggle highlights where products differ
• Each product has an "Add to Cart" button in the comparison

• Logged-in customers — Preferences saved in their account. Works across devices.
• Guest visitors — Uses a small browser cookie. No personal data stored on your server. Cookie duration is configurable (default: 30 days).
• What changes — Only the order of filters. If someone uses Color and Brand more than Size and Rating, those move up. Options and behavior stay the same.

• Saved Filters — Logged-in customers can save up to 10 filter combinations and reload them from their My Account page. Great for wholesale buyers who reorder the same categories.
• Load More / Infinite Scroll — Replace "Page 1, 2, 3" pagination with a "Load More" button or automatic scrolling. Resets properly when filters change.
• Bulk Add to Cart — For B2B/wholesale stores. Check multiple products, set quantities, add everything to cart in one click.
• Multilingual Support — Works with WPML and Polylang. Right-to-left (RTL) stylesheet included for Arabic, Hebrew, etc.
• Multi-Currency Support — Works with 5 popular currency switcher plugins. Price slider auto-adjusts to the visitor's currency.
• HPOS & Blocks Compatible — Fully works with WooCommerce's new High-Performance Order Storage and the new Cart & Checkout Blocks. No configuration needed.

• Smart Loading — Only loads code for features you've turned on. Disabled features = zero extra page weight.
• Built-In Caching — Filter counts are cached and only recalculated when products change.
• Click Throttling — 5 filter clicks in 1 second? Only the last one is processed. Prevents server overload.
• Page Builder Detection — Only loads code for the builder you use — not all 8.

• Turn On Variation Cache — Pre-calculates size/color combinations for instant lookups. Click "Build Cache" once — it auto-refreshes when products change.
• Turn On Product Index — Creates a dedicated lookup table. Noticeably faster on large catalogs.
• Adjust Cache Duration — Default: 1 hour. Lower it if inventory changes often, increase to 24 hours if products rarely change.

Works with WP Rocket, LiteSpeed Cache, W3 Total Cache, and most others. If filtered results look stale, add this to your caching plugin's exclusion list:

• /?wc-ajax=filterkit_*

Detects these themes and applies fixes automatically:

• Astra (and Starter Templates), Flatsome, WoodMart, Kadence, OceanWP, GeneratePress, Storefront, Avada, flavor

Not on the list? "Generic" compatibility mode works with most WooCommerce themes. Email support if you have issues.

Elementor, Divi, Bricks, Breakdance, Beaver Builder, Oxygen, WPBakery, Gutenberg / Block Editor (with 4 native blocks).

• Multilingual: WPML, Polylang
• Currency: WCML, Aelia, CURCY, Currency Switcher for WooCommerce, Price Based on Country
• Caching: WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, WP Fastest Cache
• SEO: Yoast SEO, Rank Math, SEOPress, All in One SEO
• WooCommerce: HPOS, Cart & Checkout Blocks

Clear your caching plugin and CDN cache. Variation Cache and Product Index rebuild automatically.

Plugins → Deactivate. Turns off filters on the front end but keeps all your settings and data. Reactivate anytime.