- Help Center Home
- Getting started
- Introducing FacetWP
- Installation and your account
- FAQ
- How it works
- What are facets?
- Facet types
- Built-in facet types
- Checkboxes
- Dropdown
- Radio
- fSelect
- Hierarchy
- Slider
- Search
- Autocomplete
- Date Range
- Number Range
- Rating
- Proximity
- Map
- Pager + load more
- Sort
- Reset
- User Selections
- Add-on facet types
- Hierarchy Select
- Range List
- Time Since
- A-Z Listing
- Color
- Exclude
- Legacy facet types
- Proximity (legacy)
- Map (legacy add-on)
- Custom facet types
- Custom facet types
- Indexing
- Listing templates
- Extras & integrations
- Add-on features and extras
- Using FacetWP with …
- Built-in integrations
- Advanced Custom Fields
- WooCommerce
- SearchWP
- WP-CLI
- Add-on integrations
- Blocks
- Bricks
- Elementor
- Beaver Builder
- WP Recipe Maker and Tasty Recipes
- Relevanssi
- WPML and Polylang
- Meta Box
- Flatsome (theme)
- External integrations
- Breakdance
- Document Library Pro
- Listify (theme)
- Listable (theme)
- WPGraphQL
- Tips, tricks and known issues
- WordPress multi-site
- WP All Import
- WebToffee Import Export
- Intuitive Custom Post Order
- Custom Taxonomy Order
- Category Order and Taxonomy Terms Order
- Advanced Taxonomy Terms Order
- Post Types Order
- Easy Digital Downloads
- EDD Reviews
- WP Job Manager
- Genesis framework
- WP External Links
- ElasticPress
- Yoast SEO
- All in One SEO (Pro)
- The Events Calendar (Pro)
- Google Analytics 4
- Image Optimization by Optimole
- Meow Lightbox
- Cookiebot
- Members
- MemberPress
- Co-Authors Plus
- Weglot
- Caching, hosting & security
- Object caching
- WP Rocket
- Cloudflare
- WP Engine
- Pressable
- New Relic
- WordPress REST API Authentication
- All-In-One Security (AIOS)
- Fast Velocity Minify
- Incompatibilities
- Incompatible plugins and themes
- Troubleshooting
- Troubleshooting guide
- Using the right query
- Common issues
- Common indexing issues
- Get support
- Developers
- Hooks reference
- Indexing hooks
- Querying hooks
- Output hooks
- facetwp_facet_display_value
- facetwp_facet_html
- facetwp_facet_render_args
- facetwp_facet_pager_link
- facetwp_facet_sort_options
- facetwp_template_html
- facetwp_shortcode_html
- facetwp_render_params
- facetwp_render_output
- facetwp_builder_item_value
- facetwp_builder_dynamic_tags
- facetwp_builder_dynamic_tag_value
- Advanced hooks
- facetwp_i18n
- facetwp_scripts
- facetwp_assets
- facetwp_asset_html
- facetwp_facet_types
- facetwp_facets
- facetwp_templates
- facetwp_facet_sources
- facetwp_excluded_custom_fields
- facetwp_excluded_custom
_fields_like - facetwp_use_preloader
- facetwp_debug_hooks
- facetwp_admin_settings_capability
- upt_admin_settings_capability
- Deprecated hooks
- JavaScript reference
- Shortcodes reference
- How FacetWP works
- The FacetWP URL
- FacetWP speed and limits
- FacetWP and taxonomies
- FacetWP REST API
- Tutorials
- Code snippets library
- Feedback
- What’s new
- News and announcements
- Changelog
Why are my facets not working on mobile?
In the following scenarios, facets may not work correctly on mobile:
- If you have a “Filter” link/button that opens a custom mobile sidebar containing your facets. If that link/button is set up as a link with a hash in its
href, like this:<a href="#", when it is clicked, the#will be added to the page URL. This causes issues with FacetWP’s facet refresh, which uses URL variables. Be aware that some page builders automatically add a hash when creating a button or link element with an emptyhrefattribute. To fix this, replace the#or emptyhrefwithjavascript:;, like this:
<a href="javascript:;">Filter</a>
- Note that you can also use FacetWP’s Mobile Flyout add-on to create a sidebar with facets.
- If there are SSL issues. We’ve mostly seen this happen in IOS Safari. Often, users are testing a
http://URL, while the page is trying to connect to thehttps://URL for the facet refresh. To fix this, make sure to force-redirect non-securehttp://URLs to securehttps://URLs. Most hosts have settings for this. You can also do this manually by adding aRewriteRulein your.htaccessfile, or by using a plugin, like Really Simple SSL. If this is not the issue, try re-adding the SSL certificate for your domain. - If you have some sort of security or firewall app installed on your phone. Try deactivating these kinds of apps while testing.
- It could be that the issue is not caused by being on mobile, but because you are testing on mobile while not being logged-in. Several scenarios and issues can cause a difference between being logged in and being logged out. One of them is Yoast SEO’s “Remove unregistered URL parameters” setting (which must be disabled), which only has an effect when you are logged out. Other possible culprits are member plugins like Members and Memberpress. Or you may be restricting WordPress or FacetWP REST API access to logged-in users only.
- The FacetWP URL
- The Mobile Flyout add-on
- Using FacetWP with Yoast SEO
- Using FacetWP with the Members plugin
- Using FacetWP with the MemberPress plugin
- The FacetWP REST API
- How to pass authentication data through REST API requests
- Using FacetWP with the WordPress REST API Authentication plugin
See also
Last updated: May 14, 2026