WooCommerce Product Filter Not Showing on Mobile: Causes and Fixes
The filter works on a computer, but on a phone the sidebar is gone, the Open filter button never appears, or it appears and does nothing. A WooCommerce product filter not showing on mobile is rarely broken. HUSKY's mobile mode has three moving parts: the server decides that the visitor uses a phone, a script moves the button to its place, and a tap opens the form as a full-screen panel. Each part can be stopped by the theme, a page builder, a cache or an optimizer. This guide shows which part failed and how to fix it.
How HUSKY mobile mode works
Many themes do not display the sidebar on phones at all. If the filter is a sidebar widget and nothing else is set up, that alone explains why it is missing. Mobile mode is the plugin's way to give phones a button that opens the filter. There is no global "mobile" switch in the settings; mobile mode is enabled per filter form:
- Widget: set Mobile mode to Yes in the HUSKY widget.
- Shortcode:
[woof sid="mobile" mobile_mode=1]. Thesidattribute is required; without itmobile_modeis ignored. - Front builder: switch on Mobile mode in the options of the
[woof_front_builder]form.
When the page is generated for a phone, the plugin prints that form hidden and adds two buttons to it, Open filter and Close filter. On desktops the same form is displayed as usual. When the page loads on a phone, a script moves the Open filter button out of the hidden form into a visible place:
- the container printed by the [woof_mobile] shortcode, if the page has one;
- otherwise the element matching
.woocommerce-products-header, the block with the shop or category title in WooCommerce's standard archive template.
A tap on the button adds the class woof_show_filter_for_mobile to the form, which turns it into a fixed full-screen panel over the page. In AJAX mode the panel closes by itself after each filtering, so the visitor sees the new products.
Two facts explain most problems. First, "phone" is decided on the server by WordPress's wp_is_mobile() from the request headers, not by screen width. Second, [woof_mobile] only marks a place: it shows nothing unless the same page also has a form with mobile mode on.
The Open filter button does not appear
The template has no place for it. Elementor and Divi theme builder templates, Avada layouts, custom pages that list products with the [products] shortcode and many custom themes often lack the .woocommerce-products-header block. The button then stays inside the hidden form. Put [woof_mobile] exactly where the button should be, usually above the products, in a Shortcode widget or block. This is the most common fix. It prints nothing on desktops, so it can stay on the page.
If you cannot place a shortcode in that template, point the button to an element of your own with the woof_mobile_btn_place_container hook. Give that element a unique ID (in Elementor: Advanced → CSS ID) and use it:
/*
* HUSKY: where to put the mobile "Open filter" button.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_mobile_btn_place_container', function ($selector) {
return '#filter-button-place';
});
Use a selector that matches one element only. A broad class such as .elementor-widget-container copies the button into every matching element on the page. The hook is not used when the page has a [woof_mobile] container.
Other reasons the button is missing:
- The place is hidden on phones by the theme (a header or toolbar that only shows on desktops). Choose a place that is visible on mobile.
- The button shows at first and disappears after filtering: the
[woof_mobile]container sits inside the product list that AJAX replaces. Move it above the list. - JavaScript optimization delays scripts until the first tap or scroll ("delay JavaScript execution" in WP Rocket and similar features). The button is moved only when the plugin's script runs. Exclude
/wp-content/plugins/woocommerce-products-filter/from delay, defer and combine, then clear the caches. The details are in the filter with WP Rocket and caching. - CSS optimization (combining or "removing unused CSS") stripped the plugin's styles, so the button exists in the page but is hidden or unstyled. Exclude the plugin's CSS as well.
- You are testing on a tablet. Safari on iPad and Chrome on larger Android tablets request the desktop version of sites by default, so these tablets get the desktop layout. If the theme hides the sidebar at tablet width, the filter is gone there; show the sidebar with CSS or place the form in the content area.
The button is there but nothing opens
The form sits inside something hidden. The button has moved out, but the panel is still the form itself, in its original place. If the theme hides the sidebar on phones with display: none, the panel opens inside a hidden box and stays invisible. There are three ways out:
- Show the sidebar on phones with CSS. The HUSKY form inside it stays hidden until the button is tapped, but other widgets of that sidebar become visible too, so this suits a sidebar that holds only the filter.
- Move the mobile-mode form out of the sidebar into the content area, for example above the products.
- Leave the widget for desktops (its Mobile mode No) and let the plugin place a filter above the products on phones only: Options → Set filter automatically → Yes, but only for mobile devices, plus Design → Hide auto filter by default → Yes for a show/hide button. This needs a template that runs the standard WooCommerce product loop.
A typical rule for the first way, with the selector adapted to your theme:
/* Theme hides #secondary (sidebar) on phones: keep it for the HUSKY panel */
@media (max-width: 768px) {
body.woocommerce-page #secondary {
display: block;
}
}
The same happens when the filter lives inside a theme's off-canvas drawer or an Elementor popup: the drawer or popup has its own visibility and scripts, and the panel cannot open from inside it. Use either the drawer or HUSKY's mobile mode, not both.
The sid contains a space. Skin syntax like sid="flat_grey woof_auto_3_columns" works for the look of the form, but in 3.4.6 the mobile button cannot find a form whose sid has two words. Use a one-word sid for a form in mobile mode.
There are two copies of the filter. Page builders often contain one section for desktop and a duplicate for mobile, hidden with responsive visibility. Both are in the HTML, only hidden by CSS, so two forms with the same identifiers fight each other: sections stop opening, two filter icons appear, or the button opens the copy you cannot see. Keep one filter per page and let mobile mode handle phones.
A script error. Open the page on the phone, or in desktop device emulation after a reload, and check the browser console. An error in any script loaded before HUSKY's stops it too.
Mobile layout on a desktop, desktop layout on a phone
Because the decision is made when the page is generated, a page cache that stores one copy for everyone serves whatever device visited first. Desktop visitors then get the Open filter button and a hidden form, or phone visitors get the full sidebar and no button, and it changes after each cache clearing. The fix is in the cache, not in the filter:
- WP Rocket: enable mobile caching and Separate cache files for mobile devices.
- LiteSpeed Cache: turn on Cache Mobile.
- Cloudflare page caching, Varnish or a hosting cache: cache by device type, or exclude the shop and category pages.
Clear every cache after the change. The same applies to the slideout extension's mobile visibility and to Set filter automatically with the values Yes, but only for mobile devices and Yes, but only for desktop, which also use wp_is_mobile().
For the same reason, resizing a desktop browser window never switches the filter to mobile mode. Test on a real phone, logged out, or in the browser's device emulation with a page reload.
Problems inside the opened panel
Drop-downs are collapsed, empty or open the keyboard. The Chosen and SelectWoo drop-downs calculate their width when the page loads, while the form is still hidden, and they come with a search field that brings up the phone keyboard. The cleanest fix is Design → Drop-down skin → Native: phones then show their own selection list, with no search field and no width problems. To keep Chosen or SelectWoo, give them a minimum width:
/* HUSKY: drop-downs collapsed in a hidden or narrow container */
.woof .chosen-container,
.woof .select2-container {
min-width: 200px;
}
The panel is see-through, hidden under a sticky header, or its text is invisible. The panel is slightly transparent by default and uses z-index: 9999, which some sticky headers exceed. Adjust it in your custom CSS:
/* HUSKY mobile panel: opaque, above the sticky header, readable text */
.woof_show_filter_for_mobile.woof {
opacity: 1;
z-index: 100000;
}
.woof_show_filter_for_mobile.woof h4,
.woof_show_filter_for_mobile.woof label {
color: #333;
}
If the panel still opens under the header (the header sits in a stacking context the panel cannot rise above), add padding-top: 90px; to the first rule, so the Close filter button starts below the header.
The panel closes after every tap. With autosubmit and AJAX, each choice runs the filter, and the panel closes to show the results. If visitors usually combine several options, turn autosubmit off for this form, [woof sid="mobile" mobile_mode=1 autosubmit=0], so they choose and then tap the filter button.
Small glitches on iPhone. A misaligned placeholder in the text search field is fixed with .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; }. Product counters of label-type filters that drift away from their labels are fixed with .woof_container_label .woof_list_label li { position: relative; }.
Changing the button
The look of the button is set in the Design tab: Image for mobile filter button, Text for mobile filter button, Image to close mobile filter and Text to close mobile filter. Enter -1 in an image field to show text only, or in a text field to show the icon only. Spacing and colour are plain CSS on .woof_show_mobile_filter, for example .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }.
For the basic setup steps, see how to display the filter on mobile devices; for every attribute of the main shortcode, the [woof] reference.
Checklist
- One filter form on the page, with mobile mode on (widget option, or
mobile_mode=1with a one-wordsid, or the front builder option). [woof_mobile]placed where the button belongs, outside the product list, in a place visible on phones.- The form itself is not inside a sidebar, drawer or popup that is hidden on phones.
- The plugin's JavaScript and CSS are excluded from delay, defer, combine and unused-CSS removal.
- The page cache keeps separate copies for mobile devices, and all caches were cleared.
- Tested on a real phone or with device emulation and a reload, logged out.
If the filter still does not show on a phone, open a topic on the HUSKY support forum with the page link, the shortcode or widget settings you use, and the errors from the browser console.