Why am I seeing “FacetWP was unable to auto-detect the post listing”?

If you see this error, FacetWP can’t find a suitable query. This usually happens when you have a custom WP_Query on a standard WordPress page. To let FacetWP detect the custom query, you have to add facetwp => true to the query arguments. See this section for more information.

This error can also happen:

• If you are using the WP External Links plugin.
• If the facetwp-template class exists multiple times on a page.

Or, if you are hosting your site on WP Engine:

• By WP Engine caching FacetWP’s API URL.
• If you are using WP Engine’s object cache.

See also

• Using a custom WP_Query
• Troubleshooting guide
• Using FacetWP with WP External Links
• Using FacetWP with Cloudflare
• Using FacetWP with WP Engine
• Why do I see no results after using facets?