Sort context

Serverless Stack

Use a Painless script to sort the documents in a query.

params (Map, read-only)

User-defined parameters passed in as part of the query.

doc (Map, read-only)

Contains the fields of the current document. For single-valued fields, the value can be accessed via doc['fieldname'].value. For multi-valued fields, this returns the first value; other values can be accessed via doc['fieldname'].get(index)

_score (double read-only)

The similarity score of the current document.

double or String

The sort key. The return type depends on the value of the type parameter in the script sort config ("number" or "string").

The standard Painless API is available.

To run the example, first install the eCommerce sample data.

The following request sorts documents by the average price per item, calculated by dividing the taxful_total_price by the total_quantity.

Documents with a higher average item price appear at the top of the results.

GET /kibana_sample_data_ecommerce/_search
{
  "sort": {
    "_script": {
      "type": "number",
      "script": {
        "lang": "painless",
        "source": """
            doc['taxful_total_price'].value / doc['total_quantity'].value
        """
      },
      "order": "desc"
    }
  }
}