• Have you hit the Re-index button?
  • Does a valid listing template exist on your page?
  • Do you see a facetwp-template class on a container element surrounding your listing? If not, check the documentation on the listing template type you are using for ways to fix this. In most scenarios, you can add this class manually. If you are using an optimization plugin, check if you have an HTML minification setting enabled. HTML minification will remove FacetWP’s <!--fwp-loop--> HTML comment, which (on some listing template types) is used to automatically detect the listing and add the needed facetwp-template class. This happens most often using Cloudflare’s “Auto Minify” feature, and using Fast Velocity Minify.
  • Is your post type searchable? (is the exclude_from_search parameter set to false when the post type is registered)?
  • Does your facet show any rows after indexing? If not, there could be something wrong with the facet’s selected Data Source. Make sure that you select a valid data source and check if your posts have (valid) values saved for the selected field. After making corrections, re-index again to see the updated row counts. To check if facets are working okay in general, create a test facet with its Data Source set to “Post Type” and re-index. This is a Data Source that should always work.
  • For some specific types of custom fields — like serialized data or relationship fields — you may need to tell FacetWP’s indexer how to properly index the data.
  • Are there any JavaScript errors in your browser’s Console that can be fixed or give a clue?
  • Turn on Debug Mode and make sure that FacetWP is using the right query.
  • Is the WordPress wp_footer() function present in your (child) theme’s footer section? The footer section is usually a file named footer.php. If this function is not there, FacetWP’s JavaScript and CSS assets cannot load in the footer, resulting in empty facets. Also code snippets using the “wp_footer” action will not work. If wp_footer(); is not present in your footer.php (or your main template, if it does not use a separate footer include), you can add it manually by adding <?php wp_footer(); ?> to the file, right before </body>. And of course, make sure footer.php is actually included in the template used.
  • Do you have post IDs higher than 4294967295 (2^32-1)? If so, your posts cannot be properly indexed because of the limitations of the database field that stores these post IDs. Implement this fix to increase this limit.

See also