@coveo/headless
    Preparing search index...

    Interface CoreFacetOptions

    interface CoreFacetOptions {
        facetId?: string;
        facetSearch?: FacetSearchOptions;
        field: string;
        filterFacetCount?: boolean;
        injectionDepth?: number;
        numberOfValues?: number;
        resultsMustMatch?: FacetResultsMustMatch;
        sortCriteria?: FacetSortCriterion;
        tabs?: { excluded?: string[]; included?: string[] };
    }

    Hierarchy (View Summary)

    Index

    Properties

    facetId? facetSearch? field filterFacetCount? injectionDepth? numberOfValues? resultsMustMatch? sortCriteria? tabs?

    Properties

    facetId?: string

    A unique identifier for the controller. By default, a random unique identifier is generated.

    facetSearch?: FacetSearchOptions

    Facet search options.

    field: string

    The field from which to display values in the facet.

    filterFacetCount?: boolean

    Whether to exclude the parents of folded results when estimating the result count for each facet value.

    Note: Resulting count is only an estimation, in some cases this value could be incorrect.

    true

    injectionDepth?: number

    The maximum number of results to scan in the index to ensure that the facet lists all potential facet values.

    Note: A high injectionDepth may negatively impact the facet request performance.

    Minimum: 0

    1000

    numberOfValues?: number

    The number of values to request for this facet. Also determines the number of additional values to request each time this facet is expanded, and the number of values to display when this facet is collapsed.

    Minimum: 1

    8

    resultsMustMatch?: FacetResultsMustMatch

    The criterion to use for specifying how results must match the selected facet values.

    atLeastOneValue

    sortCriteria?: FacetSortCriterion

    The criterion to use for sorting returned facet values.

    The sortCriteria option does not apply when making a facet search request. It is only used for sorting returned facet values during a regular Coveo search request.

    Learn more about sortCriteria values and the default behavior of specific facets in the Search API documentation.

    automatic

    tabs?: { excluded?: string[]; included?: string[] }

    The tabs on which the facet should be enabled or disabled.

    Settings

    Member Visibility
    In this article
    Properties