ProductListFacetDisplayExtension Class
The ProductListFacetDisplayExtension class is the base class for registering a custom presentation for list product facets on the product list and search pages.
Add-ons inherit from this class to declare a presentation that admin users can assign to list facets in the product search index. Each add-on must also export matching React display components from its webstore entry module. See Facet presentations (ADK) and Implementing a custom facet presentation.
Note
Built-in list facet presentations (List and SearchList) are described in ProductSearchFacetDisplayType reference. Custom presentations extend those options.
Properties
Type
public abstract string Type { get; }
The unique identifier of the list facet presentation within the add-on package.
This value must match the key used in the add-on's facets.list export and is stored in Sana Admin when an admin user assigns the presentation to a facet.
Title
public abstract string Title { get; }
The display title of the list facet presentation shown in Sana Admin when admin users select a presentation for a facet.
Hidden
public virtual bool Hidden => false;
The value indicating whether the facet should be hidden on the storefront.
When true, the facet remains fully functional in page data (filtering, URL state, and facet calculations continue to work) but no UI is rendered, including the facet header. This replaces earlier CSS-based workarounds for keeping a facet in page configuration without showing it to shoppers.
Override this property to return true for hidden presentations:
public override bool Hidden => true;
Example
using Sana.Extensions.Search;
namespace Sana.Extensions.CustomFacetPresentations;
public class ChipListFacetDisplayExtension : ProductListFacetDisplayExtension
{
public override string Type => "ChipList";
public override string Title => "Chip list";
}