API Reference / Settings API Parameters

Settings API Parameters

Index settings parameters

Here is the list of parameters you can use with the set settings method (settings scope).

Parameters that can be overridden at search time also have the search scope.

attributes

searchableAttributes
settings

The complete list of attributes used for searching.

attributesForFaceting
settings

List of attributes to use for faceting.

unretrievableAttributes
settings

List of attributes you don’t want the engine to retrieve at query time.

attributesToRetrieve
settings search

This parameter controls which attributes to retrieve and which not to retrieve.

ranking

mode
settings

Activate or deactivate NeuralSearch for a participating index.

ranking
settings

Controls how Algolia should sort your results.

customRanking
settings

Specifies which attributes to assign to Algolia’s custom ranking criterion.

relevancyStrictness
settings search

Controls the relevancy threshold below which less relevant results aren’t included in the results.

replicas
settings

Creates replicas (copies) of an index.

faceting

maxValuesPerFacet
settings search

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

sortFacetValuesBy
settings search

Controls how facet values are fetched.

highlighting-snippeting

attributesToHighlight
settings search

List of attributes to highlight.

attributesToSnippet
settings search

List of attributes to snippet, with an optional maximum number of words to snippet.

highlightPreTag
settings search

The HTML string to insert before the highlighted parts in all highlight and snippet results.

highlightPostTag
settings search

The HTML string to insert after the highlighted parts in all highlight and snippet results.

snippetEllipsisText
settings search

String used as an ellipsis indicator when a snippet is truncated.

restrictHighlightAndSnippetArrays
settings search

Restrict highlighting and snippeting to items that matched the query.

pagination

hitsPerPage
settings search

Set the number of hits per page for paginating the search results.

paginationLimitedTo
settings

Maximum number of hits accessible through pagination.

typos

minWordSizefor1Typo
settings search

The minimum number of characters in a query word before typos are considered.

minWordSizefor2Typos
settings search

The minimum number of characters in a query word before two typos are considered.

typoTolerance
settings search

Controls whether typo tolerance is enabled and how it is applied.

allowTyposOnNumericTokens
settings search

Whether to allow numeric typos in the query.

disableTypoToleranceOnAttributes
settings search

A list of searchable attributes for which you want to turn off typo tolerance.

disableTypoToleranceOnWords
settings

A list of words for which you want to turn off typo tolerance.

separatorsToIndex
settings

Control which separators are indexed.

languages

ignorePlurals
settings search

Treats singular, plurals, and other forms of declensions as matching terms.

attributesToTransliterate
settings

Specify on which attributes to apply transliteration.

removeStopWords
settings search

Removes stop (common) words from the query before executing it.

camelCaseAttributes
settings

List of attributes for which to split camel case words.

decompoundedAttributes
settings

Specify on which attributes in your index Algolia should apply word segmentation, also known as decompounding.

keepDiacriticsOnCharacters
settings

List of characters that the engine shouldn’t automatically normalize.

customNormalization
settings

Override the default normalization handled by the engine.

queryLanguages
settings search

Sets languages for language-specific settings such as plurals, stop words, and dictionaries for detecting words in CJK languages.

indexLanguages
settings

Sets the languages at the index level for language-specific processing, such as tokenization and normalization.

decompoundQuery
settings search

Splits compound words into their composing atoms in the query.

rules

enableRules
search settings

Whether Rules should be globally enabled.

personalization

enablePersonalization
search settings

Enable the Personalization feature.

query-strategy

queryType
search settings

Controls if and how query words are interpreted as prefixes.

removeWordsIfNoResults
settings search

Selects a strategy to remove words from the query when it doesn’t match any hits.

advancedSyntax
settings search

Enables the advanced query syntax.

optionalWords
settings search

A list of words that should be considered optional when found in the query.

disablePrefixOnAttributes
settings

List of attributes for which you want to turn off prefix matching.

disableExactOnAttributes
settings search

List of attributes for which you want to turn off the exact ranking criterion.

exactOnSingleWordQuery
settings search

Controls how the exact ranking criterion is computed when the query contains only one word.

alternativesAsExact
settings search

List of alternatives that should be considered an exact match by the exact ranking criterion.

advancedSyntaxFeatures
settings search

Allows you to specify which advanced syntax features are active when ‘advancedSyntax’ is enabled.

performance

numericAttributesForFiltering
settings

List of numeric attributes that can be used as numerical filters.

allowCompressionOfIntegerArray
settings

Enables compression of large integer arrays.

advanced

attributeForDistinct
settings

Name of the attribute to deduplicate or group records.

distinct
settings search

Deduplicate or group results.

replaceSynonymsInHighlight
settings search

Whether to highlight and snippet the original word that matches the synonym or the synonym itself.

minProximity
settings search

Precision of the proximity ranking criterion.

responseFields
settings search

Choose which fields to return in the API response. This parameters applies to search and browse queries.

maxFacetHits
settings search

Maximum number of facet hits to return during a search for facet values.

attributeCriteriaComputedByMinProximity
settings search

When the Attribute criterion is ranked higher than Proximity in your ranking formula, Proximity selects which searchable attribute is matched in the Attribute criterion.

userData
settings

Lets you store custom data in your indices.

renderingContent
settings

Defines how you want to render results in the search interface.