API Reference / API Parameters / unretrievableAttributes
Type: list of strings
Engine default: [] (no attribute is unretrievable)
Parameter syntax
'unretrievableAttributes' => [
  'attribute'
]

Can be used in these methods:

About this parameter

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

Preventing particular attributes from being retrieved may be particularly important for security or business reasons. Some attributes may be helpful for ranking or other technical purposes but should never be seen by your users, for example, total sales, permissions, and other private information. This setting guarantees this. Attribute names are case-sensitive.

While there’s no limit to the number of attributes, adding too many attributes can slow down calls to getSettings and reduce the responsiveness of Algolia’s dashboard.

Usage notes

This setting is ignored if the query is authenticated with the admin API key.

Examples

Make some attributes unretrievable

1
2
3
4
5
$index->setSettings([
  'unretrievableAttributes' => [
    'total_number_of_sales'
  ]
]);
Did you find this page helpful?