NOTE: You are looking at documentation for an older release. For the latest information, see the current release documentation.

« Arrays Range datatypes »
Elastic Docs ›Elasticsearch Guide [6.8] ›Mapping ›Field datatypes

Binary datatype

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Binary datatype

edit

The binary type accepts a binary value as a Base64 encoded string. The field is not stored by default and is not searchable:

PUT my_index
{
  "mappings": {
    "_doc": {
      "properties": {
        "name": {
          "type": "text"
        },
        "blob": {
          "type": "binary"
        }
      }
    }
  }
}

PUT my_index/_doc/1
{
  "name": "Some binary blob",
  "blob": "U29tZSBiaW5hcnkgYmxvYg==" 
}

The Base64 encoded binary value must not have embedded newlines \n.

Parameters for binary fields

edit

The following parameters are accepted by binary fields:

doc_values

Should the field be stored on disk in a column-stride fashion, so that it can later be used for sorting, aggregations, or scripting? Accepts true or false (default).

store

Whether the field value should be stored and retrievable separately from the _source field. Accepts true or false (default).

« Arrays Range datatypes »