Skip to main content
FilterIQRequest access
Menu
Type to search across all documentation
NavigateEnterOpenEscClose
4 min read

How Filters Work

Understanding how FilterIQ generates and displays product filters.

How Filters Work

FilterIQ creates dynamic product filters from your Shopify product data — variants, tags, metafields, and more. Filters update in real-time as shoppers make selections, showing only relevant options.

Architecture

Filters are powered by our search engine's faceted search capability:

  1. Filterable attributes are defined during AI Setup or manual configuration
  2. Product data is indexed with all filterable attributes
  3. When a shopper selects a filter, the query includes filter constraints
  4. The search engine returns matching products AND updated facet counts — so remaining filter options show accurate counts
  5. The filter sidebar updates to reflect available options for the current result set

This means if a shopper selects "Red" in the color filter, the size filter only shows sizes available for red products.

Filter Data Sources

Filters can be created from any of these Shopify product data sources:

SourceExample FiltersSetup
Variant optionsColor, Size, MaterialAutomatic via AI Setup
Product tagsCategory, Style, SeasonAutomatic via AI Setup
Product typeClothing, Accessories, ShoesAutomatic
VendorBrand/manufacturerAutomatic
PricePrice rangeAutomatic
MetafieldsAny custom attributeManual or AI-detected
InventoryIn Stock / Out of StockVia merchandising rules
Compare-at priceOn Sale filterAutomatic if compare-at prices exist

Filter Display Types

Color Swatches

Circular color samples that shoppers can click to filter by color. Colors are detected from variant option names:

  • Named colors ("Red", "Blue", "Navy") → mapped to CSS colors
  • Hex codes in metafields → displayed directly
  • Custom color mappings configurable in dashboard

Size Selectors

Button-style selector showing available sizes. Sizes that are unavailable (filtered out) appear grayed out:

  • Auto-detects common size formats: S/M/L/XL, numeric (6, 7, 8, 9), US/UK/EU
  • Supports custom size scales

Range Sliders

Dual-handle slider for numeric attributes:

  • Price range (auto-configured from product prices)
  • Weight
  • Any numeric metafield
  • Shows min/max values
  • Input fields for direct number entry

Star Ratings

1-5 star rating filter. Requires a rating metafield on products:

  • Shows "4 stars & up", "3 stars & up" format
  • Works with Judge.me, Loox, and other review apps that store ratings in metafields

Checkbox Lists

Multi-select checkboxes for any attribute:

  • Product tags
  • Product types
  • Vendors
  • Custom metafield values
  • Shows count of matching products next to each option

Boolean Toggles

On/off switches for binary attributes:

  • "In Stock Only"
  • "On Sale"
  • "Free Shipping"
  • Custom boolean metafields

Filter Behavior

Multi-Select vs Single-Select

  • Multi-select (default for checkboxes): Shopper can select multiple values. Results include products matching ANY selected value (OR logic)
  • Single-select (default for color swatches): Only one value active at a time

Configurable per filter in the dashboard.

Filter Counts

Each filter option shows the number of matching products. Counts update in real-time as other filters are applied:

  • "Red (23)" means 23 products match the current search/filter state AND are red
  • Options with 0 matches are hidden by default (configurable to show grayed out)

Filter Ordering

Filter options can be ordered by:

  • Count (most products first) — default
  • Alphabetical (A-Z)
  • Custom order — drag and drop in the dashboard

Clear Filters

  • Individual filters have a "Clear" action
  • A "Clear All" button resets all filters
  • Active filters are shown as removable chips above results

Mobile Experience

On mobile devices (under 768px):

  • Filters move into a slide-out drawer triggered by a "Filters" button
  • The drawer slides in from the bottom or side (configurable)
  • All filter types are touch-optimized with 44px minimum tap targets
  • An "Apply Filters" button closes the drawer and updates results
  • Filter count badge on the trigger button shows number of active filters

Performance

  • Filter operations are handled by the search engine and typically respond in under 50ms
  • Filter state is maintained in URL parameters for shareable/bookmarkable filtered views
  • No full page reload — filters update results dynamically via JavaScript
Was this page helpful?