← All docs

Schema & Facets

Every field XSearch discovers in your catalog appears on the Search Schema page: BigCommerce native fields, product custom fields, variant options, and enriched attributes.

Facet types

  • Checkbox / Multiselect — classic value lists, with counts.
  • Text swatches — compact chips, square or round.
  • Range / Slider — numeric fields like price or spec values.
  • Category tree — hierarchical navigation matching your BigCommerce category tree. Choosing a parent category includes everything beneath it.

Good defaults

  • Variant options (Color, Size, Material…) become checkbox filters as soon as they are first indexed. You can change or turn them off like any other field.
  • Your storefront shows every field marked as a facet that isn't suppressed.
  • Hide a field everywhere by suppressing it; hide it for particular categories or brands with per-category or per-brand facet configuration (Growth and Pro plans respectively).
  • Identifiers and long text — SKU, UPC, MPN, name, description — can't be made facets. They are searched instead; see Search & Part Numbers.

Value handling

  • Delimited values ("red; blue; green") can be split into separate facet values by configuring a delimiter on the field.
  • Products with no value for a facet field can be shown as a "(No value)" option, which is useful for finding data gaps.

Type changes and delimiter changes take effect on the next full reindex.