restrictSearchableAttributes

Type: list of strings

Engine default: all attributes in searchableAttributes

Parameter syntax

'restrictSearchableAttributes' => [
  'attribute'
]

restrictSearchableAttributes: [
  'attribute'
]

restrictSearchableAttributes: [
  'attribute'
]

'restrictSearchableAttributes': [
  'attribute'
]

restrictSearchableAttributes = [
  "attribute"
]

restrictSearchableAttributes {
    +"attribute"
    +...
}

.RestrictSearchableAttributes(
    new List<string>{ "attribute" }
)

.setRestrictSearchableAttributes(Arrays.asList(
  "attribute"
))

opt.RestrictSearchableAttributes(
  "attribute",
)

restrictSearchableAttributes = Some(Seq(
  "attribute"
))

Can be used in these methods:
search, browseObjects, searchForFacetValues, generateSecuredApiKey, addApiKey, updateApiKey search, browse_objects, search_for_facet_values, generate_secured_api_key, add_api_key, update_api_key search, browseObjects, searchForFacetValues, generateSecuredApiKey, addApiKey, updateApiKey search, browse_objects, search_for_facet_values, generate_secured_api_key, add_api_key, update_api_key search, browse, searchForFacetValues, generateSecuredApiKey, addAPIKey, updateAPIKey search, browseObjects, searchForFacetValues, generateSecuredApiKey, addApiKey, updateApiKey Search, Browse, SearchForFacetValues, GenerateSecuredApiKeys, AddApiKey, UpdateApiKey Search, browse, searchForFacetValues, generateSecuredApiKey, addApiKey, updateApiKey Search, BrowseObjects, SearchForFacetValues, GenerateSecuredAPIKey, AddAPIKey, UpdateAPIKey search, browse index, search into facet values, generateSecuredApiKey, add key, update key

See code examples

About this parameter

Limit the search for a given query to a subset of your searchable attributes.

Usage notes

This setting is a search parameter, and only affects searches that specify it.
Only works when searchableAttributes isn’t empty or null.
Attribute names are case-sensitive.

You can’t use this setting:

On an attribute that’s part of a comma-separated list of attributes within searchableAttributes. For example, if your searchableAttributes parameter contains ['title, category', 'content'], title and category are part of one comma-separated element and have the same priority, while content has its own priority level. You can set restrictSearchableAttributes to ['content'], but you can’t set restrictSearchableAttributes to ['title'], ['category'], ['title, category'] or ['title', 'category'].
To change the priority order of searchableAttributes. For example, if your searchableAttributes parameter contains ['title', 'category', 'content'], and restrictSearchableAttributes parameter contains ['category', 'title'], the engine only searches in the category and title attributes. Matches in the title attribute still rank higher than matches in the category attribute.

Examples

Search on a restricted set of attributes

In this example, let’s consider that searchableAttributes contains ['title', 'author', 'publisher', 'content'], but we only want to search in title and author

Copy

1
2
3
4
5
6
$results = $index->search('query', [
  'restrictSearchableAttributes' => [
    'title',
    'author'
  ]
]);

1
2
3
4
5
6
7
8
9
10
11
let query = Query("query")
  .set(\.restrictSearchableAttributes, to: [
    "title",
    "author"
  ])

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

1
2
3
4
5
6
7
8
9
client.execute {
  search into "myIndex" query Query(
    query = Some("query"),
    restrictSearchableAttributes = Some(Seq(
      "title",
      "author"
    ))
  )
}

Did you find this page helpful?

restrictSearchableAttributes

About this parameter

Usage notes

Examples

Search on a restricted set of attributes

On this page