# Filterable attributes
Child route of the settings route.
Attributes that can be used as filters for filtering and faceted search. You can learn more about filtering and faceted search in our dedicated guide.
Filterable attributes can also be updated through the global settings route.
# Get filterable attributes
/indexes/:index_uid/settings/filterable-attributesGet an index's filterableAttributes.
# Path variables
| Variable | Description |
|---|---|
| index_uid | The index UID |
# Example
# Response: 200 Ok
List the settings.
["genres", "director"]
# Update filterable attributes
/indexes/:index_uid/settings/filterable-attributesUpdate an index's filterable attributes list. This will re-index all documents in the index.
# Path variables
| Variable | Description |
|---|---|
| index_uid | The index UID |
# Body
An array of strings containing the attributes that can be used as filters at query time.
You can read more about this setting at the feature reference page.
# Example
# Response: 202 Accepted
{
"updateId": 1
}
This updateId allows you to track the current update.
# Reset filterable attributes
/indexes/:index_uid/settings/filterable-attributesReset an index's filterable attributes list back to its default value.
# Default value
An empty array ([]).
# Path variables
| Variable | Description |
|---|---|
| index_uid | The index UID |
# Example
# Response: 202 Accepted
{
"updateId": 1
}
This updateId allows you to track the current update.