This version of the OpenSearch documentation is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Binary field type

A binary field type contains a binary value in Base64 encoding that is not searchable.

Example

Create a mapping with a binary field:

PUT testindex 
{
  "mappings" : {
    "properties" :  {
      "binary_value" : {
        "type" : "binary"
      }
    }
  }
}

Index a document with a binary value:

PUT testindex/_doc/1 
{
  "binary_value" : "bGlkaHQtd29rfx4="
}

Use = as a padding character. Embedded newline characters are not allowed.

The following table lists the parameters accepted by binary field types. All parameters are optional.

Parameter	Description
`doc_values`	A Boolean value that specifies whether the field should be stored on disk so that it can be used for aggregations, sorting, or scripting. Optional. Default is `true`.
`store`	A Boolean value that specifies whether the field value should be stored and can be retrieved separately from the _source field. Optional. Default is `false`.

WAS THIS PAGE HELPFUL?

✔ Yes ✖ No

Tell us why

350 characters left