WARNING: Version 1.7 of Elasticsearch has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

› › ›

Template Query

edit

Template Query

edit

A query that accepts a query template and a map of key/value pairs to fill in template parameters. Templating is based on Mustache. For simple token substitution all you provide is a query containing some variable that you want to substitute and the actual values:

GET /_search
{
    "query": {
        "template": {
            "query": { "match": { "text": "{{query_string}}" }},
            "params" : {
                "query_string" : "all about search"
            }
        }
    }
}

The above request is translated into:

GET /_search
{
    "query": {
        "match": {
            "text": "all about search"
        }
    }
}

Alternatively passing the template as an escaped string works as well:

GET /_search
{
    "query": {
        "template": {
            "query": "{ \"match\": { \"text\": \"{{query_string}}\" }}", 
            "params" : {
                "query_string" : "all about search"
            }
        }
    }
}

New line characters (\n) should be escaped as \\n or removed, and quotes (") should be escaped as \\".

Stored templates

edit

You can register a template by storing it in the config/scripts directory, in a file using the .mustache extension. In order to execute the stored template, reference it by name in the file parameter:

GET /_search
{
    "query": {
        "template": {
            "file": "my_template", 
            "params" : {
                "query_string" : "all about search"
            }
        }
    }
}

Name of the the query template in config/scripts/, i.e., my_template.mustache.

Alternatively, you can register a query template in the special .scripts index with:

PUT /_search/template/my_template
{
    "template": { "match": { "text": "{{query_string}}" }},
}

and refer to it in the template query with the id parameter:

GET /_search
{
    "query": {
        "template": {
            "id": "my_template", 
            "params" : {
                "query_string" : "all about search"
            }
        }
    }
}

Name of the the query template in config/scripts/, i.e., storedTemplate.mustache.

There is also a dedicated template endpoint, allows you to template an entire search request. Please see Search Template for more details.

« Multi Term Query Rewrite Filters »