unretrievableAttributes

About this parameter

List of attributes that cannot be retrieved at query time.

You may want to ensure that under no circumstance should a particular set of attributes be returned. This is particularly important for security or business reasons, where some attributes are used only for ranking or other technical purposes, but should never be seen by your end users, for example, total_sales, permissions, and other private information. This setting guarantees this.

Usage notes:

• These attributes can still be used for indexing and/or ranking.

• This setting is bypassed when 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'
  ]
]);

1
2
3
4
5
index.set_settings({
  unretrievableAttributes: [
    'total_number_of_sales'
  ]
})

1
2
3
4
5
index.setSettings({
  unretrievableAttributes: [
    'total_number_of_sales'
  ]
});

1
2
3
4
5
index.set_settings({
    'unretrievableAttributes': [
        'total_number_of_sales'
    ]
})

1
2
3
4
5
index.setSettings([
  "unretrievableAttributes": [
    "total_number_of_sales"
  ]
])

1
2
3
4
5
6
7
index.setSettings(
  new JSONObject().put(
    "unretrievableAttributes",
    new JSONArray()
      .put("total_number_of_sales")
  )
);

1
2
3
4
5
6
IndexSettings settings = new IndexSettings
{
  UnretrievableAttributes = new List<string> { "total_number_of_sales" }
};

index.SetSettings(settings);

1
2
3
4
5
index.setSettings(
        new IndexSettings().setUnretrievableAttributes(Collections.singletonList(
                "total_number_of_sales"
        ))
);

1
2
3
4
5
res, err := index.SetSettings(search.Settings{
  UnretrievableAttributes: opt.UnretrievableAttributes(
    "total_number_of_sales",
  ),
})

1
2
3
4
5
6
7
client.execute {
  changeSettings of "myIndex" `with` IndexSettings(
    unretrievableAttributes = Some(Seq(
      "total_number_of_sales"
    ))
  )
}

1
2
3
4
5
6
7
val settings = settings {
    unretrieveableAttributes {
        +"total_number_of_sales"
    }
}

index.setSettings(settings)