Link Search Menu Expand Document

The Open Distro project is archived. Open Distro development has moved to OpenSearch. The Open Distro plugins will continue to work with legacy versions of Elasticsearch OSS, but we recommend upgrading to OpenSearch to take advantage of the latest features and improvements.


The PPL plugin adds a few settings to the standard Elasticsearch cluster settings. Most are dynamic, so you can change the default behavior of the plugin without restarting your cluster.

You can update these settings like any other cluster setting:

PUT _cluster/settings
  "transient": {
    "opendistro": {
      "ppl": {
        "enabled": "false"

Requests to _opendistro/_ppl include index names in the request body, so they have the same access policy considerations as the bulk, mget, and msearch operations. If you set the rest.action.multi.allow_explicit_index parameter to false, the PPL plugin is disabled.

You can specify the settings shown in the following table:

Setting Description Default
opendistro.ppl.enabled Change to false to disable the plugin. True
opendistro.ppl.query.memory_limit Set heap memory usage limit. If a query crosses this limit, it’s terminated. 85%
opendistro.query.size_limit Set the maximum number of results that you want to see. This impacts the accuracy of aggregation operations. For example, if you have 1000 documents in an index, by default, only 200 documents are extracted from the index for aggregation. 200