Why is my facet empty?

• 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. Also, make sure that any custom code using the facetwp_index_row hook is correct, or remove it temporarily to test (make sure to re-index after doing so). 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.
• FacetWP could be detecting the wrong query to use for filtering. Make sure that the “Advanced query detection” setting (called “Strict query detection” in FacetWP versions older than v4.5) is enabled. It prevents FacetWP’s automatic query detection from incorrectly choosing (invisible) archive queries on the page to filter.
• 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 you using Elementor, with the Element Caching feature enabled? Element Caching is incompatible with FacetWP. If you see a “FacetWP was unable to auto-detect the post listing” error, or if your facets are not showing (or disappearing after use), make sure to disable Element Caching globally or in every FacetWP-related widget.
• Is your site hosted on WP Engine, and are your facets empty after filtering? Try disabling WPE_Governor, which is a WP Engine feature that limits long queries for performance reasons. WPE_Governor can also cause the indexer to stall or not index all your posts. See our WP Engine page for other WP Engine issues and solutions.
• If you are using WPML or Polylang, with the Multilingual add-on, FacetWP expects posts to have a language. Set up translations as instructed, and make sure your page and the posts in the listing all have a language set. To filter posts without a language you can tell FacetWP to ignore the language.
• 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, usually with WP’s get_footer() function.
• If you are using the Pro version of The Events Calendar, facets will be empty if you are trying to filter a query containing the tribe_events post type. See the explanation of the issue and possible fixes.
• 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

• Indexing
• Listing templates
• What is “Advanced/Strict query detection”?
• Using FacetWP with Cloudflare
• Using FacetWP with Fast Velocity Minify
• Why am I seeing “FacetWP was unable to auto-detect the post listing”?
• Using FacetWP with Advanced Custom Fields
• Using FacetWP with Pods
• The facetwp_index_row hook
• Using FacetWP with Elementor
• Using FacetWP with WP Engine
• Troubleshooting guide
• Using the right query
• Using FacetWP with The Events Calendar
• The facetwp_assets hook
• How to use custom code?
• Why do my facets disappear?