Skip to main content
  • Type: list<string>
  • Default: []
  • Scope: settings,search
  • Deprecated name: disableTypoToleranceOn
The disableTypoToleranceOnAttributes parameter lets you turn off typo tolerance for specific attributes, which must be a subset of the searchableAttributes index setting. This means that a user query must match those attributes exactly, without spelling corrections.

​
Usage

This setting is useful when:
  • Precision is critical. For example, searching for product SKUs, phone numbers, or hyphenated attributes
  • You want to reduce irrelevant matches in long-form text fields like description or user-generated content. Combining this with disablePrefixOnAttributes helps narrow down fuzzy matches.
Use caution in these cases:
  • Proper nouns or intentionally misspelled titles, such as movie names or creative brand names. Instead, use disableTypoToleranceOnWords or add synonyms.
  • Named entities like people or places that might be hard to spell. In these cases, increasing typo tolerance can be more helpful.
There’s no hard limit on the number of attributes you can include, but adding too many can slow down getSettings operations and degrade performance in the Algolia dashboard.

​
Examples

​
Turn off typo tolerance for some attributes by default

Current API clients

var response = await client.SetSettingsAsync(
  "ALGOLIA_INDEX_NAME",
  new IndexSettings { DisableTypoToleranceOnAttributes = new List<string> { "serial_number" } }
);

IndexSettings settings = new IndexSettings();
settings.DisableTypoToleranceOnAttributes = new List
{
  "sku"
};

index.SetSettings(settings);

Current API clients

var response = await client.SearchSingleIndexAsync<Hit>(
  "ALGOLIA_INDEX_NAME",
  new SearchParams(
    new SearchParamsObject
    {
      Query = "query",
      DisableTypoToleranceOnAttributes = new List<string> { "serial_number" },
    }
  )
);

index.Search(new Query("query")
{
    DisableTypoToleranceOnAttributes = new List { "sku" }
});