Skip to content
FFuzzy

Reference

Filter Editor Setup Reference

Setup options for naming, page targeting, devices, activation behavior, layout, and AJAX selectors.

Updated May 25, 2026SEO-ready30 options

This Reference page covers the Setup tab in the Filter Editor. It is a manual draft for the full option Reference, not a standalone public release of the whole Reference set.

The Setup tab decides where the filter can appear, which devices can see it, whether filtering happens automatically or by button, whether AJAX is used, how the filter set is laid out, and whether this filter needs custom AJAX selectors.

General

Title

  • Public label: Title
  • Location: Filter Editor > Setup > General
  • Type: Text
  • Default value: New Filter
  • Shown when: Always.
  • Availability: Free
  • What it does: Sets the admin name of the filter set.
  • When to use: Rename it whenever the site has more than one filter set, so admins can identify the right filter quickly.
  • Side effects / performance notes: If title-based slug behavior is enabled elsewhere, renaming the filter can affect generated slugs.
  • Related options: Shortcode, Use Title As Slug.

Status

  • Public label: Status
  • Location: Filter Editor > Setup > General
  • Type: Select
  • Default value: Published
  • Shown when: Always.
  • Availability: Free
  • What it does: Controls whether the filter set is live or kept as a draft.
  • When to use: Keep the filter in Draft while building or testing, then publish it when placement and blocks are ready.
  • Side effects / performance notes: Draft filters do not render publicly even if a shortcode or page rule exists.
  • Related options: Shortcode, Display On Pages, Step Filter status.

Shortcode

  • Public label: Shortcode
  • Location: Filter Editor > Setup > General
  • Type: Read-only text with copy action
  • Default value: [fuz_filter id=1] example after the filter has an ID
  • Shown when: Always.
  • Availability: Free
  • What it does: Shows the shortcode used to place this filter set manually.
  • When to use: Use it when placing a filter in content, templates, widgets, or builder areas that accept shortcodes.
  • Side effects / performance notes: Page rules can still affect shortcode output when Apply Rules to Shortcode is on.
  • Related options: Display On Pages, Apply Rules to Shortcode, Ignore Shortcode Params.

Target Pages

Display On Pages

  • Public label: Display On Pages
  • Location: Filter Editor > Setup > Target Pages
  • Type: Select
  • Default value: All WooCommerce Pages
  • Shown when: Always.
  • Availability: Free
  • What it does: Defines the page-targeting mode for this filter.
  • When to use: Use All WooCommerce Pages for normal shop coverage, Custom Selection for specific contexts, or Shortcode Only when placement alone should control rendering.
  • Side effects / performance notes: Shortcode Only hides Apply Rules to Shortcode because page targeting no longer applies to shortcode output.
  • Related options: Page Types, Apply Rules to Shortcode, SEO URL settings.

Page Types

  • Public label: Page Types
  • Location: Filter Editor > Setup > Target Pages
  • Type: Compact checkbox grid
  • Default value: Shop Page, Product Categories, Search Results
  • Shown when: Display On Pages is Custom Selection.
  • Availability: Free
  • What it does: Selects which page types can display the filter.
  • When to use: Use it when one filter set should appear only on selected shop, archive, product, page, or post contexts.
  • Side effects / performance notes: Some page types reveal additional limit pickers for specific categories, tags, attributes, products, pages, or posts.
  • Related options: Product Categories – Limit To, Product Tags – Limit To, Product Attributes – Limit To.

Product Categories Limit To

  • Public label: Product Categories – Limit To
  • Location: Filter Editor > Setup > Target Pages
  • Type: Category accordion tree
  • Default value: All product categories
  • Shown when: Page Types includes Product Categories.
  • Availability: Free with source-listed limits; Pro removes the limit.
  • What it does: Limits the filter to specific product category branches.
  • When to use: Use it when a filter should appear only for selected product categories.
  • Side effects / performance notes: Narrow limits can hide the filter on category pages outside the selected branches.
  • Related options: Page Types, category filter blocks, Show Category Slugs.

Product Tags Limit To

  • Public label: Product Tags – Limit To
  • Location: Filter Editor > Setup > Target Pages
  • Type: Multi-select
  • Default value: All product tags
  • Shown when: Page Types includes Product Tags.
  • Availability: Free with source-listed limits; Pro removes the limit.
  • What it does: Limits the filter to specific product tag archives.
  • When to use: Use it when tag archives need a dedicated filter set.
  • Side effects / performance notes: Tag limits only affect eligible tag contexts, not unrelated page types.
  • Related options: Page Types, tag filter blocks, Display On Pages.

Product Attributes Limit To

  • Public label: Product Attributes – Limit To
  • Location: Filter Editor > Setup > Target Pages
  • Type: Attribute accordion tree
  • Default value: All product attributes
  • Shown when: Page Types includes Product Attributes.
  • Availability: Free with source-listed limits; Pro removes the limit.
  • What it does: Limits the filter to selected product attribute archives or values.
  • When to use: Use it when attribute archive pages need different filters than the main shop.
  • Side effects / performance notes: Attribute limits should match the store's actual attribute archive structure.
  • Related options: Page Types, attribute filter blocks, Product Attributes.

Custom Taxonomies Limit To

  • Public label: Custom Taxonomies – Limit To
  • Location: Filter Editor > Setup > Target Pages
  • Type: Taxonomy accordion tree
  • Default value: All custom product taxonomies
  • Shown when: Page Types includes Custom Taxonomies.
  • Availability: Free with source-listed limits; Pro removes the limit.
  • What it does: Limits the filter to selected custom product taxonomy contexts.
  • When to use: Use it when the store has custom product taxonomies that need dedicated filters.
  • Side effects / performance notes: Custom taxonomy limits require the taxonomy to exist and be used by the product catalog.
  • Related options: Page Types, taxonomy filter blocks, Theme Compatibility Mode.

Single Product Limit To

  • Public label: Single Product – Limit To
  • Location: Filter Editor > Setup > Target Pages
  • Type: Multi-select with AJAX search
  • Default value: All single products
  • Shown when: Page Types includes Single Product.
  • Availability: Free with source-listed limits; Pro removes the limit.
  • What it does: Limits the filter to selected single product pages.
  • When to use: Use it when a product page needs a related filter or finder experience.
  • Side effects / performance notes: Filters on single product pages still need a valid target product loop to affect.
  • Related options: Page Types, Apply Rules to Shortcode, Products Container Selector.

WordPress Pages Limit To

  • Public label: WordPress Pages – Limit To
  • Location: Filter Editor > Setup > Target Pages
  • Type: Hierarchical checkbox tree
  • Default value: All WordPress pages
  • Shown when: Page Types includes WordPress Pages.
  • Availability: Free with source-listed limits; Pro removes the limit.
  • What it does: Limits the filter to selected WordPress pages.
  • When to use: Use it when custom landing pages or builder pages host product loops.
  • Side effects / performance notes: The selected page still needs products or a compatible product loop for filtering to be useful.
  • Related options: Page Types, Products Container Selector, Page Builder.

WordPress Posts Limit To

  • Public label: WordPress Posts – Limit To
  • Location: Filter Editor > Setup > Target Pages
  • Type: Multi-select with AJAX search
  • Default value: All WordPress posts
  • Shown when: Page Types includes WordPress Posts.
  • Availability: Free with source-listed limits; Pro removes the limit.
  • What it does: Limits the filter to selected WordPress posts.
  • When to use: Use it when editorial content embeds product loops that should be filterable.
  • Side effects / performance notes: Posts without a compatible product loop can render the filter without useful product updates.
  • Related options: Page Types, Apply Rules to Shortcode, Products Container Selector.

Apply Rules to Shortcode

  • Public label: Apply Rules to Shortcode
  • Location: Filter Editor > Setup > Target Pages
  • Type: Toggle
  • Default value: On
  • Shown when: Display On Pages is not Shortcode Only; inside More options.
  • Availability: Free
  • What it does: Applies page targeting rules even when the filter is placed by shortcode.
  • When to use: Keep it on when shortcode placements should still respect page eligibility rules.
  • Side effects / performance notes: Turning it off can make a shortcode render in contexts that the page rules would normally block.
  • Related options: Shortcode, Display On Pages, Ignore Shortcode Params.

Hide Without Products

  • Public label: Hide Without Products
  • Location: Filter Editor > Setup > Target Pages
  • Type: Toggle
  • Default value: On
  • Shown when: Always.
  • Availability: Free
  • What it does: Hides the filter when there are no relevant products for the current context.
  • When to use: Keep it on to avoid showing a filter that cannot affect visible products.
  • Side effects / performance notes: Context detection depends on product queries and may need compatibility settings on custom loops.
  • Related options: No Products Text, Hide Empty Filter Values, Products Container Selector.

Force Show Only This Filter

  • Public label: Force Show Only This Filter
  • Location: Filter Editor > Setup > Target Pages
  • Type: Toggle
  • Default value: Off
  • Shown when: Inside More options.
  • Availability: Free
  • What it does: Forces this filter to show without syncing with other filter sets on the page.
  • When to use: Use it when multiple filters are present but this one should remain independent.
  • Side effects / performance notes: Independent filters can confuse shoppers if several controls affect the same product list differently.
  • Related options: Filter Synchro, Reset All Filters On Page, Display On Pages.

Devices

Display On Device

  • Public label: Display On Device
  • Location: Filter Editor > Setup > Devices
  • Type: Select
  • Default value: Both
  • Shown when: Always.
  • Availability: Free
  • What it does: Chooses whether the filter appears on desktop, mobile, or both.
  • When to use: Use it when a filter set should be device-specific.
  • Side effects / performance notes: Device targeting depends on breakpoint behavior, so verify tablet and mobile widths.
  • Related options: Custom Breakpoint, Floating Devices, Default Mobile Breakpoint.

Custom Breakpoint

  • Public label: Custom Breakpoint
  • Location: Filter Editor > Setup > Devices
  • Type: Toggle with number
  • Default value: Off; 768 px value available
  • Shown when: Inside More options.
  • Availability: Free
  • What it does: Overrides the default breakpoint used for device-specific behavior.
  • When to use: Use it when the theme's responsive breakpoint differs from the plugin default.
  • Side effects / performance notes: A mismatch between theme and plugin breakpoints can create awkward tablet layouts.
  • Related options: Display On Device, Default Mobile Breakpoint, Filter Width (Mobile).

Mobile Layout

  • Public label: Mobile Layout
  • Location: Filter Editor > Setup > Devices
  • Type: Select
  • Default value: Inherit
  • Shown when: Inside More options.
  • Availability: Free
  • What it does: Controls the mobile layout mode for this filter or inherits the global setting.
  • When to use: Override it when one filter set needs a different mobile layout from the site default.
  • Side effects / performance notes: Mobile layout changes should be checked with long labels, collapsed blocks, and touch targets.
  • Related options: Collapse Blocks on Mobile, Default Mobile Breakpoint, Floating Devices.

Filtering Mode

Activation Type

  • Public label: Activation Type
  • Location: Filter Editor > Setup > Filtering Mode
  • Type: Select
  • Default value: Auto
  • Shown when: Always.
  • Availability: Free
  • What it does: Chooses whether filtering updates automatically or waits for an apply button.
  • When to use: Use Auto for quick filtering and button mode when shoppers should make several choices before updating results.
  • Side effects / performance notes: Auto mode can create more requests on large catalogs unless debounce and performance settings are tuned.
  • Related options: Filter Button Text, Update Products on Selection, AJAX Debounce.

Enable AJAX

  • Public label: Enable AJAX
  • Location: Filter Editor > Setup > Filtering Mode
  • Type: Toggle
  • Default value: On
  • Shown when: Always.
  • Availability: Free
  • What it does: Updates product results without a full page reload.
  • When to use: Keep it on for most modern product filtering experiences.
  • Side effects / performance notes: AJAX requires correct selectors for products, pagination, result count, and sorting.
  • Related options: Products Container Selector, Product Container Selector, Pagination Selector, Result Count Selector, OrderBy Selector.

Layout

Filter Set Orientation

  • Public label: Filter Set Orientation
  • Location: Filter Editor > Setup > Layout
  • Type: Radio
  • Default value: Vertical
  • Shown when: Always.
  • Availability: Free
  • What it does: Sets whether the filter set stacks vertically or lays out horizontally.
  • When to use: Use Vertical for sidebars and long filters, or Horizontal for compact top-of-list filter bars.
  • Side effects / performance notes: Horizontal layouts need responsive width and overflow testing.
  • Related options: Overflow Behavior, Item Width, Horizontal Breakpoint.

Overflow Behavior

  • Public label: Overflow Behavior
  • Location: Filter Editor > Setup > Layout
  • Type: Radio
  • Default value: Wrap
  • Shown when: Filter Set Orientation is Horizontal.
  • Availability: Free
  • What it does: Controls how horizontal filter items behave when they exceed available width.
  • When to use: Use Wrap for multi-line bars or a non-wrapping behavior only when the container can support it.
  • Side effects / performance notes: Overflow choices affect mobile wrapping and may hide controls if the theme clips overflow.
  • Related options: Filter Set Orientation, Item Width, Horizontal Breakpoint.

Item Width

  • Public label: Item Width
  • Location: Filter Editor > Setup > Layout
  • Type: Select
  • Default value: Equal
  • Shown when: Filter Set Orientation is Horizontal.
  • Availability: Free
  • What it does: Controls how wide each horizontal filter item is.
  • When to use: Use Equal for balanced filter bars or Custom when a fixed width is needed.
  • Side effects / performance notes: Equal widths can waste space for short controls and crowd long labels.
  • Related options: Item Width Value, Overflow Behavior, Block Width (Desktop).

Horizontal Breakpoint

  • Public label: Horizontal Breakpoint
  • Location: Filter Editor > Setup > Layout
  • Type: Number
  • Default value: 768 px
  • Shown when: Filter Set Orientation is Horizontal.
  • Availability: Free
  • What it does: Sets the breakpoint where horizontal layout should change for smaller screens.
  • When to use: Align it with the theme's breakpoint so horizontal filters collapse cleanly.
  • Side effects / performance notes: Incorrect breakpoints can make horizontal filters cramped on tablets.
  • Related options: Filter Set Orientation, Custom Breakpoint, Default Mobile Breakpoint.

Item Width Value

  • Public label: Item Width Value
  • Location: Filter Editor > Setup > Layout
  • Type: Number with unit
  • Default value: 200 px
  • Shown when: Item Width is Custom.
  • Availability: Free
  • What it does: Sets the custom width used by horizontal filter items.
  • When to use: Use it when every item in a horizontal filter bar should have a predictable width.
  • Side effects / performance notes: Fixed widths can create wrapping or overflow on smaller containers.
  • Related options: Item Width, Filter Set Orientation, Block Width (Desktop).

AJAX Selectors

Products Container Selector

  • Public label: Products Container Selector
  • Location: Filter Editor > Setup > AJAX Selectors
  • Type: Text
  • Default value: Uses global selector; global default is .products
  • Shown when: AJAX is enabled; inside More options.
  • Availability: Free
  • What it does: Overrides the global selector for the product list container for this filter.
  • When to use: Use it when this filter is placed on a page with a custom product loop wrapper.
  • Side effects / performance notes: A wrong selector can prevent AJAX updates or replace the wrong page area.
  • Related options: Enable AJAX, Product Container Selector, Plugin Settings AJAX selectors.

Product Container Selector

  • Public label: Product Container Selector
  • Location: Filter Editor > Setup > AJAX Selectors
  • Type: Text
  • Default value: Uses global selector; global default is .product
  • Shown when: AJAX is enabled; inside More options.
  • Availability: Free
  • What it does: Overrides the selector for individual product items for this filter.
  • When to use: Use it when the theme uses custom product-card markup on this page.
  • Side effects / performance notes: Incorrect item selectors can affect loading placeholders, animations, and update behavior.
  • Related options: Enable AJAX, Products Container Selector, Show Placeholder While Loading.

Pagination Selector

  • Public label: Pagination Selector
  • Location: Filter Editor > Setup > AJAX Selectors
  • Type: Text
  • Default value: Uses global selector; global default is .woocommerce-pagination
  • Shown when: AJAX is enabled; inside More options.
  • Availability: Free
  • What it does: Overrides the pagination selector for this filter.
  • When to use: Use it when pagination markup differs from the global setting on a custom page.
  • Side effects / performance notes: A wrong selector can leave stale pagination after filtering.
  • Related options: Enable AJAX, Products Container Selector, Browser Back Button.

Result Count Selector

  • Public label: Result Count Selector
  • Location: Filter Editor > Setup > AJAX Selectors
  • Type: Text
  • Default value: Uses global selector; global default is .woocommerce-result-count
  • Shown when: AJAX is enabled; inside More options.
  • Availability: Free
  • What it does: Overrides the result-count selector for this filter.
  • When to use: Use it when a custom theme or builder moves the result count element.
  • Side effects / performance notes: A wrong selector can leave stale count text even when products update.
  • Related options: Enable AJAX, Pagination Selector, Show Counts in Filters.

OrderBy Selector

  • Public label: OrderBy Selector
  • Location: Filter Editor > Setup > AJAX Selectors
  • Type: Text
  • Default value: Uses global selector; global default is .orderby
  • Shown when: AJAX is enabled; inside More options.
  • Availability: Free
  • What it does: Overrides the sort-control selector for this filter.
  • When to use: Use it when the page has a custom sorting control that should stay synchronized with filtering.
  • Side effects / performance notes: A wrong selector can break sorting after AJAX updates.
  • Related options: Enable AJAX, Disable Plugin Sorting, Sort By filter block.