maxValuesPerFacet

Type: integer

Engine default: 100

Parameter syntax

'maxValuesPerFacet' => max_value

maxValuesPerFacet: max_value

maxValuesPerFacet: max_value

'maxValuesPerFacet': max_value

"maxValuesPerFacet": max_value

maxValuesPerFacet: Int = maxValue

IndexSettings settings = new IndexSettings();
settings.MaxValuesPerFacet = max_value;

.setMaxValuesPerFacet(max_value)

opt.MaxValuesPerFacet(max_value)

maxValuesPerFacet = Some(max_value)

Can be used in these methods:
search, setSettings, browseObjects, generateSecuredApiKey, addApiKey, updateApiKey search, set_settings, browse_objects, generate_secured_api_key, add_api_key, update_api_key search, setSettings, browseObjects, generateSecuredApiKey, addApiKey, updateApiKey search, set_settings, browse_objects, generate_secured_api_key, add_api_key, update_api_key search, setSettings, browse, generateSecuredApiKey, addAPIKey, updateAPIKey search, setSettings, browseObjects, generateSecuredApiKey, addApiKey, updateApiKey Search, SetSettings, Browse, GenerateSecuredApiKey, AddApiKey, UpdateApiKey Search, setSettings, browse, generateSecuredApiKey, addApiKey, updateApiKey Search, SetSettings, BrowseObjects, GenerateSecuredAPIKey, AddAPIKey, UpdateAPIKey search, setSettings, browse index, generateSecuredApiKey, add key, update key

See code examples

About this parameter

The maximum number of facet values to return for each facet in a regular search.

To set the number of facet values returned in a regular search use maxValuesPerFacet but to set the maximum number of hits to return in a searchForFacetValues, use maxFacetHits, instead.

Guides The difference between `maxValuesPerFacet` and `maxFacetHits`

How to retrieve facets

Usage notes

For performance reasons, the maximum value for maxValuesPerFacet is 1,000. You can set it higher but the engine will interpret it as 1,000 .

Examples

For example, if an ecommerce site has 443 different phone brands, and a user searches for “phone”, this default setting will only return the top 100 brands.

Copy

1
2
3
$index->setSettings([
  'maxValuesPerFacet' => 100
]);

1
2
3
4
5
6
7
8
let settings = Settings()
  .set(\.maxValuesPerFacet, to: 100)

index.setSettings(settings) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

This search setting will override the default maxValuesPerFacet but just for the current search. For example, on an ecommerce site, if a user searches for “iphone”, this setting will only return the top 20 iPhone brands.

Copy

1
2
3
$results = $index->search('query', [
  'maxValuesPerFacet' => 20
]);

1
2
3
4
5
6
7
8
let query = Query("query")
  .set(\.maxValuesPerFacet, to: 20)

index.search(query: query) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

Did you find this page helpful?

maxValuesPerFacet

About this parameter

Usage notes

Examples

Set the default number of facet values to retrieve

Set the maximum number of facet values for the current query

On this page