> For the complete documentation index, see [llms.txt](https://docs.abtasty.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.abtasty.com/commerce/browse-controls/facet-management.md).

# Facet management

This guide explains how to configure and manage facets (filters) within the **Browse Controls** section of the Commerce App . Facet management allows you to control how product filters are displayed to your users, optimizing product discovery and navigation .

{% stepper %}
{% step %}

### Create Facet

1. Navigate to the **Commerce App** .
2. Under the **Browse Controls** menu, select **Facet management** .
3. Click on **Create Facet** to open the setup screen .
   {% endstep %}

{% step %}

### Define the Scope (Search Cases)

Choose when this facet configuration should be applied to search results :

* **All:** Applies these facets to all search queries .
* **Specific:** Target specific search queries. Type the designated search terms into the input field and press `Enter` to register them .
  {% endstep %}

{% step %}

### Add and Configure Filters

<figure><img src="/files/s6BhviOd7ZisHbsnG5Gg" alt=""><figcaption></figcaption></figure>

Click the **Add filter +** button to open the **New filter** modal . Fill in the following details:

1. **Attribute:** Select the product attribute you want to use as a filter from the dropdown (e.g., *Price*, *Color*, *Brand*, *Size*)
2. **Filter behavior:** Check **Filter opened by default** if you want this filter section expanded when the page loads
3. **Display mode:** Choose how the filter options should be rendered for users :
   * **Multi-select checkboxes:** Best for discrete options like brand names or categories.
   * **Color palette:** Best for visual color swatches
   * **Range picker:** Best for numeric ranges like prices
4. Click **Create** to add the filter to your configuration list
   {% endstep %}

{% step %}

### Organize and Reorder Filters

Once filters are added, they will appear under the **Filters display** section:

* Use the drag handles (drag indicator dots `::`) on the left of each filter to drag and drop them into your preferred display order.
* Click the dropdown arrow on the right of a filter card to edit its specific settings.
  {% endstep %}

{% step %}

### Save and Apply

Once you are satisfied with the configuration:

1. Review your filters in the main list.
2. Click the **Save and apply** button in the top right corner to publish the changes to your storefront.
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.abtasty.com/commerce/browse-controls/facet-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.