Sortable attributes

Child route of the settings route.

Sortable attributes can also be updated through the global settings route.

Attributes that can be used together with the sort search parameter. To learn more about sortable attributes, refer to our dedicated guide

WARNING

Updating the settings means overwriting the default settings of Meilisearch. You can reset to default values using the DELETE routes.

Get sortable attributes

GET

/indexes/{index_uid}/settings/sortable-attributes

Get an index's sortableAttributes. The index uid is required.

Example

curl \
  -X GET 'http://localhost:7700/indexes/books/settings/sortable-attributes'

client.index('books').getSortableAttributes()

client.index('books').get_sortable_attributes()

$client->index('books')->getSortableAttributes();

client.index("books").getSortableAttributes();

client.index('books').sortable_attributes

client.Index("books").GetSortableAttributes()

let sortable_attributes: Vec<String> = client.index("books").get_sortable_attributes().await.unwrap();

client.index("books").getSortableAttributes { (result) in
  switch result {
  case .success(let attributes):
    print(attributes)
  case .failure(let error):
    print(error)
  }
}

await client.index('books').sortableAttributes();

Response: 200 Ok

List the settings.

[
  "price", 
  "author.surname"
]

Update sortable attributes

POST

/indexes/{index_uid}/settings/sortable-attributes

Update an index's sortable attributes list. This will re-index all documents in the index. This will re-index all documents in the index. The index uid is required.

If an attribute contains an object, you can use dot notation to set one or more of its keys as a value for this setting: "sortableAttributes": ["author.surname"].

You can read more about sorting at query time on our dedicated guide.

Body

An array of strings containing the attributes that can be used to sort search results at query time.

You can read more about this setting at the feature reference page.

Example

curl \
  -X POST 'http://localhost:7700/indexes/books/settings/sortable-attributes' \
  -H 'Content-Type: application/json' \
  --data-binary '[
    "price",
    "author"
  ]'

client.index('books')
  .updateSortableAttributes([
    'price',
    'author'
  ])

client.index('books').update_sortable_attributes([
  'price',
  'author'
])

$client->index('books')->updateSortableAttributes([
  'price',
  'author'
]);

Settings settings = new Settings();
settings.setSortableAttributes(new String[] {"price", "author"});
client.index("books").updateSettings(settings);

client.index('books').update_sortable_attributes([
  'price',
  'author'
])

sortableAttributes := []string{
  "price",
  "author",
}
client.Index("books").UpdateSortableAttributes(&sortableAttributes)

let sortable_attributes = [
  "price",
  "author"
];

let task: Task = client.index("books").set_sortable_attributes(&sortable_attributes).await.unwrap();

client.index("books").updateSortableAttributes(["price", "author"]) { (result) in
  switch result {
  case .success(let task):
    print(task)
  case .failure(let error):
    print(error)
  }
}

await client.index('books').updateSortableAttributes([
  'price',
  'author'
]);

Response: 202 Accepted

{
    "uid": 1,
    "indexUid": "movies",
    "status": "enqueued",
    "type": "settingsUpdate",
    "enqueuedAt": "2021-08-11T09:25:53.000000Z"
}

You can use this uid to get more details on the status of the task.

Reset sortable attributes

DELETE

/indexes/{index_uid}/settings/sortable-attributes

Reset an index's sortable attributes list back to its default value. The index uid is required.

Default value

An empty array ([]).

Example

curl \
  -X DELETE 'http://localhost:7700/indexes/books/settings/sortable-attributes'

client.index('books').resetSortableAttributes()

client.index('books').reset_sortable_attributes()

$client->index('books')->resetSortableAttributes();

//Not yet implemented

client.index('books').reset_sortable_attributes

client.Index("books").ResetSortableAttributes()

let task: Task = client.index("books").reset_sortable_attributes().await.unwrap();

client.index("books").resetSortableAttributes() { (result) in
  switch result {
  case .success(let attributes):
    print(attributes)
  case .failure(let error):
    print(error)
  }
}

await client.index('books').resetSortableAttributes();

Response: 202 Accepted

{
    "uid": 1,
    "indexUid": "movies",
    "status": "enqueued",
    "type": "settingsUpdate",
    "enqueuedAt": "2021-08-11T09:25:53.000000Z"
}

You can use this uid to get more details on the status of the task.