Selected facet pill reference for Loomi AI for Shopify

Experience customization lets you personalize selected facet pills in your storefront. Selected facet pills are the active filter chips that appear above the product grid when a shopper applies a filter. Use the data attribute and EJS variables on this page to customize how each pill displays its label and remove control.

For page layout requirements, see HTML and EJS reference for Loomi AI for Shopify.

Selected facet pill component.

Data attributes

AttributeElementValueBehavior
data-br-actionRemove controlfacet-chip-removeClick removes the chip from the active-filters row and clears the filter value from the facet selection. Fires br-facet-change. The parent unchecks the matching facet option, updates other chips, and refreshes the product grid. The chip disappears on the next render.

EJS variables

The facetChip object exposes these fields:

FieldDescriptionData type
facetNameFacet group name.string
optionNameHuman-readable option label.string
filterValueValue removed when the chip is cleared.string
displayTextDefault label: facetName: optionName.string
allSelectedOptionsFull selection for this facet after removal.string[]
actionsData attribute constants for event delegation: { remove }.object

Example

<div>
  <span><%= facetChip.displayText %></span>
  <button
    type="button"
    data-br-action="<%= facetChip.actions.remove %>"
    aria-label="Remove <%= facetChip.displayText %>"
  >
    X
  </button>
</div>


© Bloomreach, Inc. All rights reserved.