Filter facet widget representing a filterable attribute in the search interface. Widgets are created during the facet conversion process after Elasticsearch returns facet field data. The widget structure and behavior are controlled by FacetConfiguration database records managed via the administration interface.

Widget Type Determination:

If a FacetConfiguration exists for the attribute, it specifies the widget type, aggregation settings, and display options (name, order, widget_kwargs)
If no FacetConfiguration exists, fallback rules apply:
- category_ids always uses Category Widget
- basket_offer_ids always uses Promotion Widget
- All other attributes default to Multi Select Widget

Facet Configuration Properties:

Widget type (multiselect, category, range, attribute_value, visual_swatch, etc.)
Widget kwargs (labels, sorting mode, display options)
Facet type and aggregation settings
Custom settings and display order
Translatable name and widget_kwargs for multi-language support

Facet fields are retrieved from Elasticsearch first, before product results. The facet field size (number of choices) is determined as follows:

If facet field has a FacetConfiguration, uses configured size from facet_kwargs
If attribute key is "category_ids", size is set to 500
Otherwise, default size is 100

Facet fields are returned with inventory strategy context, as prices and availability may vary by inventory strategy. For multi-inventory scenarios, price-related facets automatically adapt to show the active price list.