WordPress.org

Plugin Directory

Category AJAX Filter – Posts, Custom Post Types & Product Filter

Category AJAX Filter – Posts, Custom Post Types & Product Filter

Description

THE COMPLETE FILTER SOLUTION: POSTS, CUSTOM POST TYPES & WOOCOMMERCE PRODUCTS. DRAG-AND-DROP BUILDER INCLUDED.

Category AJAX Filter (CAF) is a fast AJAX filter and product filter plugin for WordPress. Visitors filter posts, custom post types and WooCommerce products by categories, tags, attributes and price, with results updating instantly and no page reload. In the free drag-and-drop CAF Builder every element is a module — search box, dropdowns, checkboxes, range slider, image, title, price, buttons and more — each fully customizable and positioned exactly where you want, with no coding and responsive controls to fine-tune every module for tablet and mobile. Display anywhere with a shortcode. Category AJAX Filter Pro adds AI-powered search, advanced analytics, SEO controls, custom field filtering, attribute swatches, product badges, float button for mobile and more.

🔨 How the CAF Builder Works

Building filters with CAF is straightforward. Follow 3 simple steps to create your complete filtering solution. Each step is independent, so you can focus on one part at a time. If you want to connect the filter to your existing product layout instead of building a listing, just create the filter in step 1 and skip the rest.

The 3-step builder flow

  1. Query & Filters: Choose to build a query by taxonomy conditions with no filter UI, or design a visual filter using modules like Search, Dropdown, Checkbox, Range Slider, Reset, and Custom Text, each customizable for font, color, background, border, box shadow, and sizing, etc. For WooCommerce, filter products by categories, tags, attributes, and price.
  2. Post Item Template: Design how each post card looks using modules like Post Image, Post Title, Post Description, Post Date, Post Author, Comment Count, Terms, and Post Button, each customizable for font, color, background, border, box shadow, and sizing, etc. For WooCommerce products, add Product Image, Product Price, Add to Cart, and Badges modules.
  3. Layout Settings: Set number of columns, posts or products per page, vertical and horizontal gap, and default post order. Position your filter in sidebar, top, or bottom with full sizing control for filter and post layout. In Layout Controls, manage and customize pagination.

Row, column & module system
The builder is structured around Rows, Columns, and Modules. Each one has the same three tabs, Settings, Design, and Advanced. Learn it once and use it everywhere in the builder.

Classic Panel
The Classic Panel is still available and fully supported alongside the Builder, nothing is being taken away.

⭐ Key Features

CAF includes the core features you need to create professional, fully customized post and product filters. From instant AJAX filtering to pre-built templates, everything is designed for simplicity and power.

  • AJAX-Powered Instant Filtering: Filters use AJAX to update results instantly without page reload. Visitors see filtered posts and products in real-time as they select categories, tags, or search anything across your content.

  • Drag-and-Drop 3-Step Builder: The visual CAF Builder simplifies filter creation into three steps: Query & Filters to set filtering logic, Post Item Template to design post and product cards, Layout Settings to control columns, posts per page, gaps, sort order, filter position, and pagination.

  • Works with Any Post Type & WooCommerce: Filter posts, custom post types, and products by categories, tags, attributes, price, or any custom taxonomy using Search, Dropdown, Checkbox, and Range Slider modules. Connect the WooCommerce product filter to your existing shop layout, or build a product listing with Product Image, Price, Add to Cart, and Badges modules.

  • Pre-Built Template Library: Start with ready-made filter layouts and post item designs. Export your work as JSON to reuse across sites, or import templates from other filters you’ve built.

🧩 Filter, Post & Product Display Modules

Filter modules

  • Search: A keyword search box that can search post titles, content, or all fields, with a customizable placeholder and search trigger.

  • Checkbox: A term filter for any taxonomy (default or custom), including WooCommerce categories, brands, and attributes. Toggle between single-select and multi-select behavior, show or hide the checkbox itself and term counts, display options as color swatches, add an optional filter label, and restyle the checkbox’s shape, size, and colors to match any design.

  • Dropdown: A single-select filter for any taxonomy (default or custom), brand, or product attribute, letting you choose exactly which terms to include, with term counts shown next to each one and an optional filter label. Display options as color swatches, and style the container, select field, and dropdown options independently.

  • Range Slider: A range filter for WooCommerce product price, with single or double handle, horizontal or vertical placement, configurable min, max, and step values, and an optional currency prefix. Pro adds custom fields plus WooCommerce weight, length, height, and width.

  • Reset: Clears all active filters with one click, with editable button text and full control over font, color, and size, including a hover state.

  • Custom Text: Add your own text or label inside the filter using a simple content field.

  • Rating [PRO]: Lets visitors filter WooCommerce products by star rating, with two display options, Star List and Stars, and full control over star color and size.

Post item modules

  • Post Image: Displays the featured image, with a choice of image size, a fallback placeholder image, and an optional link on the image. Fully customizable for width, height, spacing, border, and box shadow.

  • Post Title: Displays the post title, with an optional link to the full post and full control over font, size, color, and spacing, including a hover state.

  • Post Description: Displays the post excerpt, with a customizable word limit and the option to enable HTML.

  • Post Date: Displays the publish date, with a choice of date format and full control over font, spacing, background and border.

  • Post Author: Displays the author name, with full control over font, color, size and spacing, including a hover state.

  • Comment Count: Displays the number of comments, with a customizable suffix label and full control over font, color and size.

  • Terms: Displays taxonomy terms, and since each Terms module can be pointed at a different taxonomy, you can add several of them side by side to show categories, tags, or any other taxonomy at once, each with its own term limit, separator, link setting, and independent design.

  • Post Button: A button linking to the full post, with editable text, a choice of how the link opens and an optional suffix.

  • Custom Field [PRO]: Displays the value of any custom field on the post, with an optional prefix and suffix, each shown as text or an icon and full control over font, color, and size so any stored data can be presented in your post cards exactly how you want it.

Product modules (WooCommerce)

  • Product Image: Displays the product image, with a choice of image size, a fallback image, and an optional link to the product (gallery view in Pro).

  • Product Price: Displays the product price, with the option to show lowest or highest prices for variable and grouped products, prefix and suffix text and full control over font, color, and size.

  • Add to Cart: A product button with two modes, open the product page or add the product to cart with AJAX (in Pro), including redirect actions to cart or checkout and custom button text for simple, variable, and grouped products, with full button styling and a hover state.

  • Badges: Displays Sale and Featured badges directly on the product card, with full design control. Pro adds New, Best Seller, stock status, stock quantity and discount badges with value or percentage display, each with its own conditional settings.

  • Product Rating [PRO]: Shows the product rating on the card in two styles, Stars or the average rating value with prefix and suffix text, with full size and color control.

  • Attribute Swatches [PRO]: Displays product attributes as selectable text, color or image swatches directly on the product card, each fully styleable, so shoppers can pick a variation and add it to cart without opening the product page.

🔗 Supported Post Types & Compatibility

Post types & taxonomies

Filter default WordPress posts, any custom post type registered on your site, or WooCommerce products, using categories, tags, brands, attributes or any custom taxonomy you’ve created.

WooCommerce

Full support for simple, variable, and grouped products. Connect the filter to your existing shop layout, or build a complete custom product listing with the builder’s product modules.

Page builder & plugin compatibility

Works with all major page builders including Elementor, Divi, and WP Bakery. Compatible with popular custom post type and custom field plugins like ACF, CPT UI and Meta Box. Elementor Loop Builder support is available as a Pro feature.

🎬 Free Live Demos

Explore CAF in action across WordPress posts, custom post types, and WooCommerce products — every demo runs the free version, filtering instantly with no page reload.

👑 Category AJAX Filter Pro

Take your filters to the next level with the separate Category AJAX Filter Pro plugin. It adds advanced filtering, deeper customization, and extra integrations. From AI-powered search to WooCommerce swatches and smart badges, Pro gives you the tools to build filtering experiences that match your exact vision.

  • AI Search: Semantic, intent-based search that matches what visitors mean against post content, taxonomy terms, and labels, not just exact keywords. Works on posts and any custom post type. For WooCommerce, shoppers can also search across brands, attributes, and price range, so a query like “red shoes under 50” finds the right products. See the live AI Search demo.

  • Analytics: Get detailed insights into how visitors use your filters, including total filter clicks across categories, attributes, brands, and selected price ranges, which filter combinations return zero results, clicks broken down by device type, and a complete list of search keywords visitors used, all viewable across custom time periods to identify trends and gaps in your content and store.

  • SEO Controls: Keep filtered pages crawlable and indexable with Filter With URL support and schema markup, so search engines understand your filtered content.

  • Sort Filter Terms: Manually reorder categories, taxonomies, brands, attributes, or custom field terms in Checkbox and Dropdown filters using drag-and-drop, instead of relying on alphabetical or count-based ordering.

  • Prefix and Suffix Options: Add custom text or icons before and after data throughout your layout in key modules like Post Title, Custom Field, Post Button, Product Price, Add to Cart, and Badges, as well as result counts in your layout controls, so every piece of information displays exactly how you want it with complete customization over presentation.

  • Voice Search: Let visitors search hands-free using voice input, with a customizable microphone icon you can position left or right, and control the listening state feedback they see while speaking, making filtering more accessible and convenient.

  • Advanced Layout Controls: Place advanced pagination options like Load More, sorting dropdowns, selected filters, and result counts exactly where you want them across four flexible positions: above filters, below filters, above the post grid, or below the post grid, with drag-and-drop control that lets you arrange them however you need, even stacking multiple modules in the same position.

  • Custom Fields in Filters: Extend filtering beyond taxonomies by letting visitors filter with custom fields, including all WooCommerce product custom fields, using Checkbox, Dropdown, Range Slider, or Search modules, with the ability to target the search box to specific custom fields for more focused searching.

  • Float Button: Take full control of how your filter appears on every device. Keep it inline or in a sidebar on desktop, and show the same filter as a floating button on mobile and tablet, with full customization of the button text, icon, panel animation direction, and overlay color.

  • Product Attribute Swatches: In listing show product attributes as selectable text, color, or image swatches directly on product cards, each fully styleable. Shoppers pick their size or color and add the exact variation to cart without opening the product page, turning your filtered grid into a fast, one-stop shopping experience.

  • Smart Product Badges: Go beyond the standard Sale badge with New, Best Seller, stock status, stock quantity, and discount badges. Each badge comes with its own conditional logic, set a Low Stock Threshold to trigger a badge when inventory runs low, show discounts as an exact value or a percentage off, and combine these options to build flexible badges that appear exactly when they should.

More Pro features:

Dynamic Term Counts, Extended revision history, Custom fonts upload, Global font settings, include/exclude posts/products, Icon library, Icons/images for terms & custom fields, Masonry layout, Loader styles, Elementor Loop Builder support, Quick backend navigation.

🎯 Pro Demos

Explore CAF Pro in action with our live demo sites, showcasing advanced features, custom fields, WooCommerce product filtering, and Pro-exclusive functionality:

📚 Quick Import Library

Skip the design process — import professional, ready-made filter layouts in seconds:

  1. Create a new filter and select your post type or products.
  2. Click the Import/Export icon at the top right of the builder and open the Import tab.
  3. Click Import From Library and pick a category — Full Filter Layout, Filter, Single Post Item, or Layout Settings — then browse the ready-made designs.
  4. Select any template and click Import — the complete design with all modules and styling loads instantly.

Source Code

This plugin ships minified JavaScript for the admin filter builder. Per WordPress plugin guideline #4, human-readable source code and build tools are publicly maintained here:

  • React builder source (admin UI): https://github.com/trustyplugins/category-ajax-filter/tree/3.0/react-builder/src
  • Build tools: https://github.com/trustyplugins/category-ajax-filter/tree/3.0/react-builder (package.json, webpack.config.js, scripts/) — see react-builder/BUILD.md
  • PHP plugin source: https://github.com/trustyplugins/category-ajax-filter/tree/3.0

To rebuild the admin builder JavaScript:

git clone -b 3.0 https://github.com/trustyplugins/category-ajax-filter.git
cd category-ajax-filter/react-builder
npm install
npx cross-env CAF_BUILD_FREE=1 npx wp-scripts build

The production plugin zip contains only the compiled files under react-builder/build/.

Screenshots

Installation

Automatic installation

  1. Log in to your WordPress dashboard, go to Plugins > Add New.
  2. Search for “Category AJAX Filter”.
  3. Click Install Now, then Activate.

Manual installation

  1. Download the plugin zip file.
  2. Upload the plugin files to the wp-content/plugins/ directory, or install the zip through Plugins > Add New > Upload Plugin.
  3. Activate the plugin through the Plugins screen in WordPress.

After activation

  1. Go to the Category Filter menu in your dashboard.
  2. Choose the CAF Builder for the guided 3-step visual setup, or the Classic Panel for the original settings screens.
  3. Configure your Query & Filters, Post Item Template, and Layout Settings.
  4. Place your finished filter on any page or section using the provided shortcode.

FAQ

Does it work with WooCommerce?

Yes, fully. Filter products by categories, tags, brands, attributes, and price. Connect the filter to your existing shop layout or build a complete custom product listing with the builder’s product modules. Simple, variable, and grouped products are all supported. Star-rating filters are available in the separate Pro plugin.

Does this work with custom post types?

Yes. You can target any registered post type, not just default WordPress posts, including WooCommerce products.

Will it work with my existing layout?

Yes. Just create your filter in step 1 and place the shortcode with your existing listing — no need to rebuild it.

Does this work with Divi, Elementor, and their product grid modules?

Yes. CAF filters work with Divi and Elementor shop modules, so you can filter the product grids built with their widgets. You can also paste the CAF shortcode anywhere in any page builder.

Can I add multiple filters on the same page?

Yes. You can add multiple filters to the same page using their shortcodes.

Will this slow down my site?

Filtering happens via AJAX, so only the results update, the page itself doesn’t reload. The plugin is built to run efficiently on standard WordPress hosting.

Can I reuse a filter or layout on another site?

Yes. Use the export/import tools to move a full layout, a single filter, a module, a post item template, or just layout settings between sites.

What does AI Search actually do?

AI Search (Pro) uses semantic, NLP-based matching so results reflect what a visitor means, not just literal keyword matches. See the live AI Search demo.

Reviews

August 2, 2026
It works with custom posts and taxonomies and AJAX filtering is so fast and without page reload. The customisation options are too flexible, allow you to create professional filter and listing without writing a single line of code. I would rate in one of the best filter plugin on the internet.
May 26, 2025 1 reply
This plugin is excellent, and its so good we purchased the pro version.That’s the good, now the bad.It appears their site went down the other day (error establishing connection to the database) and then, magically, our pro plugin ‘lost’ its license and stopped working until their site went back online.It seems absurd to me that developers create licensing checks that have no redundancy which can bring a website crashing to a halt.
February 18, 2025
I bought a (quite cheap) lifetime PRO licence and I couldn’t be more satisfied with the plugin, none of the other plugin that I’ve tested come close. You can choose one of already nice default filter/posts layouts or customize even further it based on your needs. You can also filter posts by custom taxonomies in addition to categories/tags and integrate custom post types and fields.
August 14, 2024
Have just started to use this plugin. Im very impressed at how easy it is to use, and the level of support is excellent – being able to talk directly to the team on skype rather than waiting hours or days for a reply to a ticket it a real bonus.
Read all 153 reviews

Contributors & Developers

“Category AJAX Filter – Posts, Custom Post Types & Product Filter” is open source software. The following people have contributed to this plugin.

Contributors

“Category AJAX Filter – Posts, Custom Post Types & Product Filter” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Category AJAX Filter – Posts, Custom Post Types & Product Filter” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

3.0.0

(20/08/2026)
* Major update — introduces the visual CAF Builder for designing AJAX filters and post layouts from the admin.
* Added visual drag-and-drop filter builder in the admin.
* New React-based builder UI for filter and post layout design.
* Free tier includes core builder layouts, modules, and tier limits.
* WordPress Plugin Check and coding standards improvements.
* Security and escaping fixes for export and template output.

2.9.1

(17/08/2026)
* Tested up to WordPress 7.1.
* Fixed category/terms meta saving (term IDs are now sanitized as integers instead of CSS class strings).
* Fixed broken conditional stylesheet URLs caused by accidental quote characters in asset paths.

2.9.0

(06/08/2026)
* Fixed frontend AJAX failures (-1 / “Posts found: error”) on sites using page cache by refreshing the nonce via an uncached request.
* Frontend filter AJAX nonce is always verified (Security Enable/Disable option removed).
* Hardened frontend filter AJAX to use trusted filter settings from post meta.
* Admin taxonomy/terms AJAX is no longer available to logged-out users.
* Improved filter meta save capability checks.
* Readme and version updated.

2.8.5.2

(24/07/2026)
* Nonce/sanitization functions updated.
* Readme updated.

2.8.5.1

(08/06/2026)
* Admin CSS fixed.
* readme Updated

2.8.5

(25/05/2026)
* Updated admin design compatible with WordPress 7.0.
* Admin CSS fixed.

2.8.4.1

(10/03/2026)
* Readme updated.

2.8.4

(08/07/2025)
* CSS conflict issue fixed [for RankMath, WooCommerce]

2.8.3

(07/11/2024)
* Sorting feature added at the admin settings panel.
* Vulnerability fixed mentioned by Wordfence.

2.8.2

(20/05/2024)
* Plugin scanned with ‘plugin-check’ and fixed all security warnings.

2.8.1

(11/04/2024)
* ‘Read More’ and ‘All’ string translation compatibility.

2.8

(26/02/2024)
* Enhancement [PRO version (8.8) will be removed as addon]
* If using CAF PRO 8.8, user can deactivate the free version.

2.7.2.3

(19/02/2024)
* Bug fixes [Duplicate declaration error of static variable]

2.7.2.2

(15/02/2024)
* Fixed license error [compatibility with PRO]
* Bug fixes.
* Hooks added [compatibility with PRO]

2.7.2.1

(20/06/2023)
* Fixed styling and responsive issues.

2.7.2

(17/05/2023)
* Added support for WooCommerce.

2.7.1

(17/05/2023)
* Post title new tab link open [fix]
* Post description font syncing with PRO.

2.7

(02/05/2023)
* Bug fixed.
* Special CSS add class issue fixed.

2.6.7

(18/01/2023)
* New pagination added in PRO [Compatible to 8.6.5]

2.6.6

(06/01/2023)
* WordPress dashboard icon changed.

2.6.5

(23/12/2022)
* Bug fixed [Fixed function conflict – get_image_sizes]

2.6.4

(27/07/2022)
* Bug fixed [#parse error, #PRO version error]

2.6.3

(27/07/2022)
* Bug fixed [#parse error, #PRO version error]

2.6.2

(27/07/2022)
* Bug fixed [Parse Error – Due to template conflict (date.php, author.php)]

2.6

(26/07/2022)
* Restrict ABSPATH function added to files.
* Templates directory added with all used modules.
* Many developer hooks added.
* Compatible with CAF PRO [8.6]

2.5.2

(01/07/2022)

2.5.1

(01/07/2022)
* Category issue fixed when using PRO with free layouts.

2.5

(25/05/2022)
* Default filter layout’s more button hook added [text change]
* Inherit added in transform [Typography]

2.4

(01/04/2022)
* Filter layout dropdown changed [Admin Panel]
* PRO compatible version [8.4]

2.3

(15/03/2022)
* Double slash in source file bug fixed.

2.2

(09/03/2022)
* Bug fixed of parse error [of 2.1]
* PRO compatible changes [8.2]

2.1

(08/03/2022)
* PRO compatible changes [8.2]

2.0

(03/03/2022)
* Fixed isset image warning for all post layouts.
* Added dynamic CSS for all post layouts and filter layouts.
* PRO compatible [8.0]

1.9.8

(02/03/2022)
* Update patch to fix 1.9.7.

1.9.7

(02/03/2022)
* Fixed isset image warning for all post layouts.
* Added dynamic CSS for all post layouts and filter layouts.
* PRO compatible [7.7]

1.9.6

(24/02/2022)
* Missing string translation functions added (Loco Translate)
* PRO compatible version (7.6)

1.9.5

(08/02/2022)
* Fixed console error.

1.9.4

(05/02/2022)
* Fixed (Posts found: parsererror), new setting option added to enable/disable Nonce from plugin settings under ‘Advanced Tab’ (advanced->security).

1.9.3

(04/02/2022)
* Conflict fixed (jQuery is not defined)
* Language translation file added (Russian: RU)

1.9.2

(24/01/2022)
* Compatible with WordPress 5.9.

1.9.1

(12/01/2022)
* Whitespace fixed (Header information)

1.9

(12/01/2022)
* Compatible with Loco Translate.
* Admin area translatable.
* Localization and internationalization done.
* Securing (escaping) output.

1.8.9

(26/11/2021)
* Compatible version with PRO (Analytics Feature)

1.8.8

(04/09/2021)
* Bugs fixed, Font Awesome compatible version with PRO.

1.8.7

(28/08/2021)
* Meta fields show/hide functionality in PRO version [Compatible]

1.8.6

(05/08/2021)
* Fixed shortcode generator error (Dashboard shortcode fixes)

1.8.5

(30/07/2021)
* jQuery not defined error fixed.

1.8.4

(26/07/2021)
* Fixes.

1.8.3

(20/07/2021)
* Default color combination set / user experience.

1.8.2

(09/07/2021)
* Category bug fixed for post layouts.

1.8.1

(09/07/2021)
* Enable/disable scroll to div [PRO Compatible]

1.8

  • Multiple taxonomy selection feature in PRO [PRO Compatible]
    This version is compatible with PRO that has the feature of multiple taxonomy selection. We added one more new filter layout in PRO version. Now you can select multiple taxonomy for all the filters.

1.7.1

  • Select default category [PRO Compatible]

1.7

  • W3C compatible fixes.

1.6.9

  • Read More button translation compatible [PRO Compatible]

1.6.8

  • W3C compatible, bug fixed [PRO Compatible]

1.6.7

  • Multiple checkbox filter bug fixed [PRO Compatible]

1.6.6

  • Translation settings for default strings [PRO Compatible]
  • Font bug fixed for Glossy Layout.

1.6.5

  • Search field added for all filter layouts [PRO Compatible]

1.6

  • Search field bug fixed [PRO Compatible]

1.5.6

  • Search field added to search through posts [PRO Compatible]

1.5.5

  • One click demo import (PRO Compatible)

1.5.4

  • More button added in filter layout 1 (PRO Compatible)

1.5.3

  • Make PRO compatible for animation effects.

1.5.2

  • CSS bug fix for Post Layout 1.

1.5.1

  • Bug fix for Avada Builder.

1.5

  • Readme updated, demo site updated.

1.4.9

  • Bug fixed, readme updated.

1.4.8

  • Glossy Layout, Simple Blogs Layout bug fixed.

1.4.7

  • Layout bug fixed.

1.4.6

  • Layout bug fixed.

1.4.5

  • Supported for PRO version.
  • Many more hooks added.

1.4.3

  • Added three more filters.

1.4.2

  • Added one more filter to change the order of posts (Asc, Desc).

1.4.1

  • Post excerpt supports (bug fixed).

1.4

  • Backend tab fixes (now plugin saves the user’s last clicked tab)
  • Shortcode tag splitter on post content.
  • Post excerpt supports.

1.3

  • Added some filters to sort the posts/filter categories by specific order.

1.2

  • Added a filter function to order by ID for filter categories.

1.0.0

  • First version of plugin.