Child route of the settings route.
Ranking rules are built-in rules that ensure relevancy in search results. Ranking rules are applied in a default order which can be changed in the settings. You can add or remove rules and change their order of importance.
Ranking rules can also be updated directly through the global settings route along with the other settings.
Learn more about ranking rules and their relevancy.
::: note
Updating the settings means overwriting the default settings of MeiliSearch. You can reset to default values using the DELETE routes.
:::
Get the ranking rules of an index.
| Variable | Description |
|---|---|
| index_uid | The index UID |
An array that contains built-in ranking rules sorted by order of importance.
List the settings.
[
"typo",
"words",
"proximity",
"attribute",
"wordsPosition",
"exactness",
"desc(release_date)"
]Update the ranking rules of an index.
| Variable | Description |
|---|---|
| index_uid | The index UID |
An array that contain ranking rules sorted by order of importance.
To add your own ranking rule, you have to communicate either asc for ascending order or desc for descending order followed by the field name in brackets.
-
To apply an ascending sorting (results sorted by increasing value of the attribute):
asc(attribute_name) -
To apply a descending sorting (results sorted by decreasing value of the attribute):
desc(attribute_name)
More information about the body.
{
"updateId": 1
}This updateId allows you to track the current update.
Reset the ranking rules of an index to its default value.
An array that contains built-in ranking rules sorted by order of importance.
["typo", "words", "proximity", "attribute", "wordsPosition", "exactness"]To remove all ranking rules, which is not recommended in any case, you would send an empty array to the add or replace ranking rules route.
| Variable | Description |
|---|---|
| index_uid | The index UID |
{
"updateId": 1
}This updateId allows you to track the current update.